Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.1   6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4    Statistic  

DynaPDF.SetGStateFlags

Sets optional flags affecting the graphics state, coordinate handling, as well as color and image conversion rules.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
DynaPDF 5.3 Yes Yes Yes Yes Yes

MBS( "DynaPDF.SetGStateFlags"; PDF; Value { ; Reset } )

Parameters

Parameter Description Example value
PDF The PDF reference returned from DynaPDF.New. $pdf
Value The new value. Can be a number or a list including one or more of the following words: Compatible, RestorePageCoords, RealTopDownCoords, NativeBlackWhite, UseImageColorSpace, IgnoreICCProfiles, AnsiStringIsUTF8, RealPassThrough, NoBitmapAlpha or NoImageDuplCheck. 3
Reset Optional
If the parameter Reset is true, the new flags replace current flags. If set to false, the flags are combined with the current flags.
0

Result

Returns OK or error.

Description

Sets optional flags affecting the graphics state, coordinate handling, as well as color and image conversion rules.
If the parameter Reset is true, the new flags replace current flags. If set to false, the flags are combined with the current flags.
FlagDescription
RestorePageCoordsIf set, the current base coordinate system like bottom or top down is saved and restored with the graphics state.
RealTopDownCoordsThis flag is reserved for future extensions. It is not implemented yet.
NativeBlackWhiteIf set, RGB black or white is not converted to DeviceGray. This flag affects text and vector graphics but no images.
UseImageColorSpaceIf set, the active color space is ignored when inserting an image. The color space is taken from the image file instead. See also "Color spaces and Images“ in DynaPDF help file.
IgnoreICCProfilesIf set, embedded ICC profiles in image files are ignored when inserting an image. The image is inserted in the base color space instead. This flag is not meaningful if the flag gfUseImageColorSpace is absent. See also "Color spaces and Images“ in DynaPDF help file.
AnsiStringIsUTF8If set, all Ansi functions interpret string parameters as UTF-8 encoded Unicode strings. Should not be used with MBS Plugin.
RealPassThroughIf set, JPEG images are inserted as is. JPEG images are normally rebuild, also in pass-through mode, to avoid issues with certain malformed JPEG images which cannot be displayed in Adobes Acrobat or Reader. If you know that your JPEG images work then set this flag to avoid unnecessary processing time.
NoBitmapAlphaIf set, the alpha channel in bitmaps files will be ignored. This is sometimes useful since many 32 bit bitmaps contain an invalid alpha channel that makes the image fully transparent.
NoImageDuplCheckIf set, no duplicate check for images will be performed. This can significantly improve processing speeed especially for memory based images.
NoObjCompressionIf set, object compression will be disabled.

See also SetGStateFlags function in DynaPDF manual.

Examples

Set two options:

MBS( "DynaPDF.SetGStateFlags"; $pdf; "RealPassThrough, UseImageColorSpace" )

See also

Example Databases


DynaPDF.SetFontWeight   -   DynaPDF.SetImportFlags

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins