Magincross

Magincross
Developer: Sachen Publisher: Watara Platform: Watara Supervision Released internationally: 1992 This game has hidden development-related text.

Function Explanations

To do: This isn't all of it by any means. You can find these very rare fragments online though.

Scattered throughout the ROM are loads of texts straight from the Win32 API documentation. Some fragments are not complete though.

36C4:

e, the string must be null-terminated and  have the DOS filename format. If .lpFilename. 
contains a handle, the handle must be in the low-order word; the high-order word must be zero.

Return Value 
The return value specifies the outcome of the function. 
It is nonzero if the function is successful. Otherwise, it is zero.

Comments
Any application that adds or removes fonts from the Windows font table should 
notify other windows of the change by using the ..SendMessage. function with the 
.hWnd. parameter set to -1 to send a ..WM_FONTCHANGE. message to all 
top-level windows in the system.

RemoveFontResource. function may not actually remove the font r

61C4:

Parameter...Type/Description

hDC...HDC.
Identifies the device context.

nSavedDC...int.
Specifies the device context to be restored. It can be a value returned by a previous

..SaveDC. function call.
If .nSavedDC. is -1, the most recent device context saved is restored.

Return Value
The return value specifies the outcome of the function. 
It is TRUE if the specified context was restored. Otherwise, it is FALSE.

RGB utility macro

Syntax
COLORREF  RGB(.cRed., .cGreen., .cBlue.)

This macro selects an RGB color based on the parameters supplied 
and the color capabilities of the output device.

Parameter...Type/Description

cRed...BYTE.
Specifies the intensity of the red color field. 

cGreen...BYTE.
Specifies the intensity of the green color field.

cBlue...BYTE.
Specifies the intensity of the blue color field.

Return Value
The return value specifies the resultant RGB color.

Comments
The intensity for each argument can range from 0 to 255.
If all three intensities are specified as 0, the result is black.
If all three intensities are specified as 255, the result is white.

For information on using color values in a color palette, see the descriptions of the
..PALETTEINDEX. and ..PALETTERGB. macros, earlier in this chapter.

RoundRect function

RoundRect

Syntax
BOOL  RoundRect(.hDC., .X1., .Y1., .X2., .Y2., .X3., .Y3.)

This function draws a rectangle with rounded corners.
The interior of the rectangle is filled by using the selected brush,
and a border is drawn with the selected pen.

Parameter...Type/Description

DC...HDC.
Identifies the device context

X1...int.
Specifies the logical .x.-coordinate of the upper-left corner of the rectangle.

Y1...int.
Specifies the logical .y.-coordinate of the upper-left corner of the rectangle.

X2...int.
Specifies the logical .x.-coordinate of the lower-right corner of the rectangle.

Y2...int.
Specifies the logical .y.-coordinate of the lower-right corner of the rectangle.

X3...int.
Specifies the width of the ellipse used to draw the rounded corners.

Y3...int.
Specifies the height of the ellipse used to draw the rounded corners.

Return Value
The return value specifies whether the rectangle is drawn.
It is nonzero if the rectangle is drawn. Otherwise, it is zero.

Comments
The width of the rectangle specified by the .X1., .Y1., .X2., and .Y2. parameters must not exceed 32,767 units.
This limit applies to the height of the rectangle as well.

The current position is neither used nor updated by this function.

SaveDC function2

SaveDC...X

Syntax...int  SaveDC(.hDC.)

This function saves the current state of the device context specified by the .hDC. parameter 
by copying state information (such as clipping region, selected objects, and mapping mode) 
to a context stack. The saved device context can later be restored by using the .RestoreDC. function.

Parameter...Type/Description
hDC...HDC.
Identifies the device context to be saved.

Return Value
The return value specifies the saved device context. It is zero if an error occurs.

Comments
The .SaveDC. function can be used any number of times to save any number of device-context states.

ScaleViewportExt function

ScaleViewportExt

Syntax
DWORD  ScaleViewportExt(.hDC., .Xnum., .Xdenom., .Ynum., .Ydenom.)

This function modifies the viewport extents relative to the current values.
The formulas are written as follows:

xNewVE = (xOldVE x Xnum)/  Xdenom
yNewVE = (yOldVE x Ynum) / Ydenom

The new extent is calculated by multiplying the current extents by the given numerator
and then dividing by the given denominator.

Parameter...Type/Description

hDC...HDC.
Identifies the device context.

Xnum...int.
Specifies the amount by which to multiply the current .x.-extent.

Xdenom...int.
Specifies the amount by which to divide the current .x.-extent.

Ynum...int.
Specifies the amount by which to multiply the current .y.-extent.

Ydenom...int.
Specifies the amount by which to divide the current .y.-extent.

Return Value
The return value specifies the previous viewport extents (in device units).
The previous y.-extent is in the high-order word;
the previous .x.-extent is in the low-order word.

ScaleWindowExt function:

F600:

by the .wMSeconds. parameter. The caret flashes on or off each .wMSeconds. 
milliseconds. This means one complete flash (on-off-on) takes 2 x .wMSeconds. 
milliseconds

Parameter...Type/Description

MSeconds...WORD.  Specifies the new blink rate (in milliseconds)

.Return Value..None

Comments
The caret is a shared resource. A window should set the caret blink rate only if it owns the caret.
It should restore the previous rate before it loses the input focus or becomes inactive.

SetCaretPos function7

SetCaretPos
Syntax...void  SetCaretPos(.X., .Y.)

This function moves the caret to the position given by logical coordinates specified by the 
.X. and .Y. parameters. Logical coordinates are relative to the client area of the window that 
owns them and are affected by the window's mapping mode, so the exact position in pixels 
depends on this mapping mode.

The .SetCaretPos. function moves the caret only if it is owned by a window in the current task. 
.SetCaretPos. moves the caret whether or not the caret is hidden.

Parameter...Type/Description

  X...int.  Specifies the new .x.-coordinate (in logical coordinates) of the caret.
..Y...int.  Specifies the new .y.-coordinate (in logical coordinates) of the caret.

The filename TP.BAT can also be seen directly after the above three times.

(Source: AttackedByGlitch)