ImgFrame_GetProperties_JSN¶
Return the properties of an image frame.
ImgFrame_GetProperties_JSN(imgDocRef;frameIdx) ➔ framePropsJSON
| → | imgDocRef |
Text | The image document reference. |
| → | frameIdx |
Longint | The image frame index. |
| ↩︎ | framePropsJSON |
Text | The frame’s properties in JSON format |
Return the frame-level properties of an image frame.
Parameter imgDocRef is the image document reference. This method works with both raster
images and PDF documents.
Parameter frameIdx is the index of the image frame.
The image frame properties are returned in framePropsJSON as a 4D object serialized in JSON format.
The contents of frameProps may very depending on the image format and on the
specific image. Some common properties are listed in the following tables:
| Property name | Type | Description |
|---|---|---|
BitsPerChannel |
Longint |
The number of bits used to represent each color channel of the raster frame. |
HasAlpha |
Boolean |
Set to True if the raster frame pixels contain an alpha channel, False otherwise. |
IsIndexed |
Boolean |
Set to True if the raster frame pixels are index-based, False otherwise. |
ProfileName |
String |
The name of the color profile of the raster frame. |
ColorModel |
String |
The name of the color moder of the raster frame. Can be one of:
Gray, RGB, CMYK, and Lab. |
| Property name | Type | Description |
|---|---|---|
MediaBox |
RectObj |
The MadiaBox of the PDF page. |
CropBox |
RectObj |
The CropBox of the PDF page. |
Note
The ImgFrame_GetProperties method in the Q2PixLib component is a
convenience wrapper for this method that returns the frame properties directly as
a 4D object instead of a JSON serialization.
