Foundation 6

Fnd_Msg

10 shared methods.

Fnd_Msg_BackgroundProcess

Fnd_Msg_BackgroundProcess

Runs in a background process that diligently tries to make sure everybody receives their messages.

Called as a new process from the Fnd_Msg_Send method.

No parameters.

Fnd_Msg_BlobToPicture

Fnd_Msg_BlobToPicture (->blob; ->picture)

Converts a blob to a picture.

ParameterTypeDirectionDescription
blobPointerinA pointer to a blob
picturePointerinThe same blob as a picture variable

Fnd_Msg_Broadcast

Fnd_Msg_Broadcast (process name; message)

Sends the message out to all processes with the specified name.

The name can contain wildcard characters.

ParameterTypeDirectionDescription
broadcastNameTextinThe process name to send to
messageTextinThe message to send

Fnd_Msg_Get

Fnd_Msg_Get ({->blob}) --> Text

Gets the next message queued up for the current process.

ParameterTypeDirectionDescription
inBlobPointerinFor receiving an optional blob (optional)
ResultTextoutThe message

Fnd_Msg_GetParameter

Fnd_Msg_GetParameter (parameters string; num) --> Text

Gets parameters out of the message. Also see Fnd_Msg_PackParameters.

ParameterTypeDirectionDescription
inParameterListTextinA string full of parameters
inParameterListNumberinThe parameter number to get
ResultTextoutThe parameter value

Fnd_Msg_Info

Fnd_Msg_Info (label) --> Text

Returns requested information. See the Fnd_Gen_ComponentInfo method for more information.

ParameterTypeDirectionDescription
requestTextinInfo desired ("version" or "name")
ResultTextoutResponse

Fnd_Msg_PackParameters

Fnd_Msg_PackParameters (msg; param 1 {... param N}) --> Text

Adds the text parameters to the messasge using the same delimiter expected by the Fnd_Msg_GetParameter routine. This isn't rocket science, it's just easier to maintain than creating the message string in multiple methods.

ParameterTypeDirectionDescription
$1TextinThe message to append parameter to
$2..$nTextinThe parameters to add to the message
$0TextoutThe delimited paramters

Fnd_Msg_PictureToBlob

Fnd_Msg_PictureToBlob (->picture; ->blob)

Converts a picture to a blob.

ParameterTypeDirectionDescription
picturePointerinA pointer to the picture
blobPointerinA pointer to the blob to fill

Fnd_Msg_QuitBackgroundProcess

Fnd_Msg_QuitBackgroundProcess

Ends the message loop background process.

If there are messages still waiting to be delivered, this process waits until a timeout period is reached so hopefully the messages will get delivered.

No parameters.

Fnd_Msg_Send

Fnd_Msg_Send (target process; message; {->blob})

Call this method to send a message to another process.

ParameterTypeDirectionDescription
targetProcessNumberLongintinThe process to send the message to
targetProcessNumberTextinThe message to send
targetProcessNumberBlobinA blob (optional)