5.2. tsPostAddFillPattern
Syntax
Pascal
procedure tsPostAddFillPattern(PatternImageID: tsImageID; X: tsInt; Y: tsInt; ChannelMask: tsBitmask);
C/C++
void tsPostAddFillPattern(tsImageID PatternImageID, tsInt X, tsInt Y, tsBitmask ChannelMask);
Description
Fills the chars with an given image. The operation can be affected by the adjusted image modes.
You have the choice to set the position manually.
Or to let the PostProcessor choose an random position.
Params
- PatternImageID
-
The image ID which will used for the fill operation.
![[Caution]](images/caution.png)
Caution Please make sure the pattern image exist if the processor will called. This happens every time an char gets created. But it's possible that this happens minutes or hours after the creation. To prevent from this make sure the image is still be alive or you can turn of the creation of chars with the parameter TS_CREATOR_CREATE_CHARS or you can delete the post processors.
- X
-
The horizintal position where the pattern image will be placed. If this value is smaller than zero the position is random.
- Y
-
The vertical position where the pattern image will be placed. If this value is smaller than zero the position is random.
- ChannelMask
-
Indicates which channels getting filled. For an list of all available flags look in the table Channelmasks.
Error Codes
- TS_NO_ACTIVE_CONTEXT
-
If there was no context bound.
- TS_NO_ACTIVE_FONT
-
If there is no font bound.
- TS_INVALID_VALUE
-
If the given pattern ID dosn't exists.
- TS_INVALID_OPERATION
-
If the bound font isn't an font creator.