MbufPutLine()函数

Synopsis

Write a specified series of pixels within specified coordinates, along a theoretical line.

Format

void MbufPutLine(ImageBufId, StartX, StartY, EndX, EndY, Mode, NumbPixelsPtr, UserArrayPtr)

MIL_ID ImageBufId; Image buffer identifier
long StartX; X start position on the line
long StartY; Y start position on the line
long EndX; X end position on the line
long EndY; Y end position on the line
long Mode; Operation mode
long *NumPixelsPtr Number of pixels
void *UserArrayPtr; Source user array

Description

This function reads a series of pixels from a user-defined array and writes them within specified coordinates (along a theoretical line) of a specified image. The Bresenham algorithm is used to determine the theoretical line.

The ImageBufId parameter specifies the identifier of the destination image buffer. This must be a single-band (monochrome) buffer.

The StartX and StartY parameters specify the horizontal and vertical offsets (in pixels) of the starting position of the line, relative to the top-left corner pixel of the source buffer.

The EndX and EndY parameters specify the horizontal and vertical offsets (in pixels) of the finishing position on the line, relative to the top-left corner pixel of the source buffer.

The Mode parameter specifies the operation mode. This parameter must be set to M_DEFAULT.

The NumPixelsPtr parameter specifies the address of the variable from which to read the number of pixels to be written along the theoretical line. If M_NULL, the number of pixels is not available.

The UserArrayPtr parameter specifies the address of the user array from which to read the pixels to insert in the image buffer. Ensure that the user array contains all the pixels to be inserted. MbufPutLine assumes that the array is of the same data type as the destination buffer. If this parameter is set to M_NULL, the pixels are not inserted; however, if NumPixelsPtr is not M_NULL, the number of pixels to be inserted can be known.

See also

MbufGetLine

相关文章:

  1. MbufAlloc2d()函数
    Synopsis Allocate a 2D data buffer. Format MIL_ID MbufAlloc2d(SystemId, SizeX, SizeY, DataType, Attribute, BufIdPtr)...
  2. MbufChildColor()函数
    Synopsis Allocate a child data buffer within a color parent buffer. Format MIL_ID MbufChildColor(ParentBufId, Band, BufIdPtr)...
  3. MbufCopy()函数
    Synopsis Copy data from one buffer to another. Format void MbufCopy(SrcBufId, DestBufId)...
  4. MbufCopyClip()函数
    Synopsis Copy buffer, clipping data outside the destination buffer. Format void MbufCopyClip(SrcBufId, DestBufId, DestOffX, DestOffY)...
  5. MbufDiskInquire()函数
    Synopsis Inquire about the buffer data in a file. Format long MbufDiskInquire(FileName, ParamToInquire, UserVarPtr)...
  6. MbufExport
    Synopsis Export a data buffer to a file. Format void MbufExport(FileName, FileFormatBufId, SrcBufId)...
  7. MbufGet2d()函数
    Synopsis Get data from a 2D area of a buffer and place it in a user-supplied array. Format void MbufGet2d(SrcBufId,...
  8. MbufImport()函数
    Synopsis Import data from a file into a data buffer. Format MIL_ID MbufImport(FileName, FileFormatBufId, Operation, SystemId, BufIdPtr)...
  9. MbufPut2d()函数
    Synopsis Put data from a user-supplied array into a 2D area of a buffer. Format void MbufPut2d(DestBufId, OffX, OffY, SizeX,...
  10. MbufRestore()函数
    Synopsis Restore MIL file format data from a file into an automatically allocated data buffer. Format MIL_ID MbufRestore(FileName, SystemId, BufIdPtr)...

《MbufPutLine()函数》上有26条评论

评论已关闭。