03C4

  

---

Description

Displays an onscreen counter supporting text

Syntax

03C4: set_status_text_to [global var] [int] '[string]'

Parameter

[global var]

Global variable containing an integer value

[int]

Type (0 = numbers, 1 = bar)

[string]

GXT string

This opcode displays a counter, either shown in numbers or as a bar. The counter need only be called once and will automatically associate and update itself with the global variable. Counters only support global variables storing integer values. For type 1 bar, the length of the empty bar represents values between 0 and 100. Values outside the range will either underfill or overfill the empty bar. There are only two types of counters. Any values not 0 will just display type 1 counter. Additional counters cannot be displayed until the existing counter is removed. Opcode 0151 removes the counter.

Types

0	1

Example

The following example, using Sanny Builder, will create a full bar counter. Pressing the CAMERA key will deplete the bar. A number is displayed at the bottom of the screen to view the exact value of the bar. Once depleted, the counter disappears.

$100 = 100
03C4: set_status_text_to $100 1 'DUMMY'

while true
    wait 10
    if
        00E1:   key_pressed 0 13
    then
        $100 -= 1
        01E5: text_1number_highpriority 'NUMBER' $100 10 ms 1
        if
            0 >= $100
        then
            0151: remove_status_text $100
            break
        end
    end
end

See also

• 0150 – counter that does not support text
• 04F7 – counter that supports text in addition to line position

Keywords

counter, status, text, bar