ACSUtils Wiki

ACC++

anonymous@undisclosed.example.com (Anonymous) — Thu, 13 Jul 2017 16:48:40 +0000

acs_compilers ACC++ ACC++ is an abandoned alternative ACS compiler.

ACC

anonymous@undisclosed.example.com (Anonymous) — Fri, 14 Jul 2017 19:23:20 +0000

acs_compilers ACC ACC is the official ACS compiler. Alternative ACS compilers: BCC, GDCC. * GitHub: Known bugs 256 function limit ACSUtils has a lot more than 256 functions, but official releases of ACC can't compile programs with more than 256 functions. To fix this, download the April 26, 2017 development version of ACC (unofficial build for Windows):

ACS Compilers

anonymous@undisclosed.example.com (Anonymous) — Thu, 13 Jul 2017 15:43:52 +0000

ACS Compilers Known ACS compilers: * ACC -- the official ACS compiler * BCC * GDCC * ACC++ (abandoned)

Get ACSUtils version

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2019 18:10:55 +0000

Get ACSUtils version Introduction You can retrieve the version of ACSUtils used in your mod as numbers or as a string. Version as numbers For example, ACSUtils 1.8.0 defines the following constants: #define ACSUTILS_VERSION_MAJOR 1 #define ACSUTILS_VERSION_MINOR 8 #define ACSUTILS_VERSION_PATCH 0

Actor properties

anonymous@undisclosed.example.com (Anonymous) — Tue, 04 Jul 2017 12:06:55 +0000

Actor properties ACSUtils provides wrapper functions for all actor properties. For every property PropertyName, ACSUtils provides two functions: type GetActorPropertyName(int tid) void SetActorPropertyName(int tid, type value) GetActorViewHeightGetActorProperty(tid, APROP_ViewHeight)

BCC

anonymous@undisclosed.example.com (Anonymous) — Fri, 16 Feb 2018 20:11:23 +0000

acs_compilers BCC BCC is an alternative ACS compiler. * ZDoom forums: * GitHub: BCSUtils Functions return 0 by default (not a bug) function int f() {} // returns 0 If a function that returns a value reaches the end, and there is no “return” statement at the end, the function returns 0. This is done to avoid false compiler errors like this:

BCSUtils

anonymous@undisclosed.example.com (Anonymous) — Fri, 14 Jul 2017 15:28:17 +0000

BCSUtils BCSUtils is a BCC-enhanced version of ACSUtils. It has exactly the same functions and constants as ACSUtils, so all ACSUtils documentation also works for BCSUtils. Features * Strict typing for all functions and constants. * All functions are in the

Broken links

anonymous@undisclosed.example.com (Anonymous) — Thu, 13 Jul 2017 15:29:13 +0000

Broken links Orphans

Changelog

anonymous@undisclosed.example.com (Anonymous) — Tue, 20 Feb 2018 16:56:09 +0000

Changelog 1.6.1 * Added BCSUtils * Added FIXED_MIN and FIXED_MAX constants for BCSUtils. * Fixed misc. bugs in error messages. Porting guide No changes needed. 1.6.0 This release breaks backwards compatibility. Be sure to update your code accordingly. * Removed or renamed a number of functions. Read the porting guide for a complete equivalence table.

Clientside/serverside detection

anonymous@undisclosed.example.com (Anonymous) — Thu, 05 Sep 2019 20:54:37 +0000

Clientside/serverside detection Introduction You can check if a script is running serverside, clientside or in singleplayer using functions provided by ACSUtils. Terminology * Server -- an engine instance that runs the gameplay code. * Client

All constants

anonymous@undisclosed.example.com (Anonymous) — Mon, 17 Apr 2017 12:24:26 +0000

All constants Pages in this namespace: * COLORCODE * FIXED_MAX * FIXED_MIN * HUDTIC * INT_MAX * INT_MIN * MAX_PLAYERS * MAX_PLAYERS_ZDOOM * SBYTE_MAX * SBYTE_MIN * SHORT_MAX * SHORT_MIN * TEAM_NONE * UBYTE_MAX * USHORT_MAX

Cursor library

anonymous@undisclosed.example.com (Anonymous) — Fri, 14 Jul 2017 18:40:40 +0000

Cursor library The ACSUtils cursor library allows mods to easily add mouse cursor support. It fully supports wide screens and takes into account all mouse settings of the user to provide consistent cursor support regardless of aiming settings. *

ACSUtils documentation

anonymous@undisclosed.example.com (Anonymous) — Fri, 14 Jul 2017 18:13:34 +0000

ACSUtils documentation * Indexes: * All functions * All constants * Information: * Using ACSUtils * BCSUtils * Changelog * Big ACSUtils sub-libraries: * HUD Library * Cursor library * Number parsing * Input functions * Rounding functions * Actor property wrappers

Requesting functions

anonymous@undisclosed.example.com (Anonymous) — Sun, 07 Jul 2019 15:45:06 +0000

Requesting functions These functions will make a fine addition to my collection ACSUtils. function bool SetActorPositionForced(int tid, int x, int y, int z, bool fog) { bool result = Warp(tid, x, y, z, 0, WARPF_MOVEPTR|WARPF_ABSOLUTEPOSITION|WARPF_NOCHECKPOSITION); if (fog) SpawnForced("TeleportFog", x, y, z); return result; }

All functions

anonymous@undisclosed.example.com (Anonymous) — Sun, 19 Mar 2017 15:50:41 +0000

All functions Pages in this namespace: * a_GetCVarFixed * a_GetUserCVarFixed * abs * accel2grav * acos * acosec * acot * ActorDistance * ActorDistance2D * ActorExists * ang2deg * ang2rad * asec * asin * atan * atof * atoi * BotCount * CenterCursor * ChangeActorFlag * ChangeFlag * clamp * ClearHudMessage * ClearHudMessageBold * ClientCount * cmp * cond * ConsolePlayerInGame * ConsolePlayerName * ConsolePlayerTeam * cosec * cot * CursorDeltaX * CursorDeltaY *…

GDCC

anonymous@undisclosed.example.com (Anonymous) — Fri, 14 Jul 2017 13:18:27 +0000

acs_compilers GDCC GDCC is an alternative ACS compiler, and also a standards-compliant compiler of the C programming language to ACS VM bytecode. The ACS compiler part of GDCC is called GDCC-ACC. The rest is the C compiler. * ZDoom forums: * GitHub: Known bugs Missing "return" statement executes random other function's code

GetCVarFixed

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2019 01:30:01 +0000

GetCVarFixed ZDoom provides GetCVar for ints and GetCVarString for strings, but doesn't provide a way to retrieve the value of float CVars. ACSUtils implements GetCVarFixed by calling GetCVarString to retrieve the value of the CVar as a string, and parsing it with atof. -32768.032767.99997

HUD coordinate system

anonymous@undisclosed.example.com (Anonymous) — Tue, 18 Apr 2017 13:39:16 +0000

HUD coordinate system ZDoom uses a special coordinate system for HudMessages. In 4:3 resolutions, the coordinate system's rectangle matches that of the screen. In aspect ratios other than that, a 4:3 rectangle is put at the center of the screen and the remaining screen space is out of its boundaries.

HUD Library State

anonymous@undisclosed.example.com (Anonymous) — Tue, 18 Apr 2017 13:21:32 +0000

HUD Library State HUD Library has a lot of settings telling it how to draw messages. It stores them in current state. This state can be reset to default using HudResetState. It can be saved and restored using HudPushState and HudPopState respectively. 2D drawing These settings apply to 2D drawing only.

HUD Library

anonymous@undisclosed.example.com (Anonymous) — Sun, 09 Jul 2017 11:26:55 +0000

HUD Library HUD Library is an advanced replacement for HudMessage. It uses HUD Library State instead of many function arguments and implements scaling and 3D HudMessages. Here is an example: HudResetState(); // Just like calling SetFont and SetHudSize before HudMessage. HudSetPoint(320.0, 240.0); HudDrawText(1, "Hello");

Input functions

anonymous@undisclosed.example.com (Anonymous) — Sun, 09 Jul 2017 12:47:21 +0000

Input functions ACSUtils provides a simplified interface to GetPlayerInput. Function list A full list of new input functions: Key KeyAny PlayerKey PlayerKeyAny upKeyUpKeyUpAnyPlayerKeyUpPlayerKeyUpAny downKeyDownKeyDownAnyPlayerKeyDownPlayerKeyDownAny pressedKeyPressedKeyPressedAnyPlayerKeyPressedPlayerKeyPressedAny releasedKeyReleasedKeyReleasedAnyPlayerKeyReleasedPlayerKeyReleasedAny toggledKeyToggledKeyToggledAnyPlayerKeyToggledPlayerKeyToggledAny Introduction Each key can be * U…

Inventory functions

anonymous@undisclosed.example.com (Anonymous) — Sun, 25 Aug 2019 23:39:49 +0000

Inventory functions ACSUtils provide extra functions to work with actor inventory. * SetInventory * SetActorInventory * GiveMaxInventory * GiveMaxActorInventory * TakeMaxInventory * TakeMaxActorInventory * ToggleInventory * ToggleActorInventory

Inventory functions

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2019 18:34:27 +0000

Inventory functions Introduction ACSUtils provides extra functions to operate on inventory. Just like GiveInventory/GiveActorInventory and TakeInventory/TakeActorInventory, every function is provided in two variants: one operating on the activator and the other operating on the actor with the specified tid.

LookAt

anonymous@undisclosed.example.com (Anonymous) — Sun, 07 Jan 2018 23:23:38 +0000

LookAt void LookAtPoint(int tid, fixed x, fixed y, fixed z) Rotates the actor so that it's looking at the point. Takes the actor's ViewHeight into account. ---------- void LookAt(int tid, int target_tid) Rotates the actor so that it's looking at another actor. Takes into account both actors'

Math

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2019 18:26:23 +0000

Math ACSUtils provides a rich math library and covers for several missing ZDoom functions. Notes What is "num"? num means “any numeric type” (either int or fixed). Functions accepting num accept both ints and fixeds, e.g: num max(num a, num b)

Multiple return values

anonymous@undisclosed.example.com (Anonymous) — Sun, 21 Apr 2019 21:32:05 +0000

Multiple return values Some ACSUtils functions return multiple values (e.g. vector math functions, but also some non-math functions). ACS doesn't support returning multiple values from a function. ACSUtils uses a convention to fake returning multiple values from a function. The convention is as follows: there are 8 global variables with names

Named scripts in Zandronum 2.1.2

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Feb 2018 10:52:47 +0000

Named scripts in Zandronum 2.1.2 Zandronum <3.0 does not support actual named scripts, but you can use #define to give names to script numbers: #define myproject_somescript 301 #define myproject_enter 302 script myproject_somescript (void) { ... } script myproject_enter ENTER { ... }

New documentation

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2019 14:48:27 +0000

New documentation * Integrating ACSUtils into your project * BCSUtils -- a version of ACSUtils for BCC * Mouse cursor library * HUD library * Input library * Multiplayer support * Widescreen support * Actor property wrappers * Array sorting and shuffling * Bit functions * ChangeFlag for Zandronum * Character functions * GetCVarFixed * HUD functions * Inventory functions * Math functions * Number parsing functions * Port and renderer detection * Player uti…

Number parsing

anonymous@undisclosed.example.com (Anonymous) — Tue, 21 Mar 2017 14:28:24 +0000

Number parsing ACSUtils provides functions to convert strings to numbers. Bases The parsed numbers can be written in any base from 2 to 36. In bases over 10, letters of the alphabet are used as digits. If a base is not explicitly specified or is set to 0, base prefixes can be used:

Rectangle API

anonymous@undisclosed.example.com (Anonymous) — Sat, 20 Apr 2019 00:20:32 +0000

Rectangle API This is a simple library that implements basic UI elements in ACS. This library is an addon for the cursor library. ACSRecthere Define ACSUTILS_RECTLIB_SAVEDSTATES to specify the amount of required rectangles. Usage ... #define ACSUTILS_RECTLIB_USERVARS 1 // user defined #include "acsutils.acs" #include "acsrect.acs" ...

Renderer detection

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2019 17:59:25 +0000

Renderer detection Introduction You can detect whether the client is currently using the software renderer or the OpenGL renderer by calling the IsOpenGL function provided by ACSUtils. Things not to do: * don't just check GetCVar(“vid_renderer”

Rounding

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2019 18:02:25 +0000

Rounding Introduction ACSUtils provides a full set of functions to round fixed-point numbers to integers. floorceilroundsilently return 0 zspecial.acsacsutils.acs Rounding modes There are four rounding modes: * trunc -- zeroes the fractional part of the number

Source port detection

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2019 00:54:24 +0000

Source port detection Introduction You can identify what engine your mod is running in using ACSUtils. This may be useful to avoid using features if they're not present in the engine your mod is running in. IsOpenGL Functions Is * bool IsZDoom()

Welcome to the ACSUtils Wiki

anonymous@undisclosed.example.com (Anonymous) — Thu, 05 Sep 2019 20:42:16 +0000

Welcome to the ACSUtils Wiki ACSUtils is a big ACS library for Zandronum modding fully compatible with Zandronum 3.0 and (G)ZDoom >=1.8.6, and the three major ACS compilers -- ACC, BCC and GDCC. A BCC-exclusive version called BCSUtils that takes advantage of BCC is available.

String library

anonymous@undisclosed.example.com (Anonymous) — Thu, 18 Apr 2019 23:48:06 +0000

String library ACSUtils provides a rich set of functions for working with strings. Empty vs invalid strings ACS strings are actually numbers that identify actual strings in the ACS VM's string table. A number may not refer to any string at all, in that case it's an

swap()

anonymous@undisclosed.example.com (Anonymous) — Thu, 05 Sep 2019 20:42:10 +0000

swap() any, any swap(any a, any b) Returns two variables in reverse order. This function exists to improve readability when swapping the values of two variables. Examples Without swap(): int tmp = x; x = y; y = tmp; With swap(): swap(x, y); x = r1; y = r2;

Standard ZDoom units

anonymous@undisclosed.example.com (Anonymous) — Sun, 09 Jul 2017 14:13:20 +0000

Standard ZDoom units * distance -- mapunits (also called mappixels) * time -- tics (or seconds in non-gameplay contexts) * angle -- turns counterclockwise Derived units * velocity -- mapunits per tic * acceleration -- mapunits per tic^2

Using ACSUtils

anonymous@undisclosed.example.com (Anonymous) — Fri, 14 Jul 2017 17:50:14 +0000

Using ACSUtils Upgrading the compiler You must upgrade your ACS compiler to use ACSUtils because the official ACC 1.55 release can't compile files with more than 256 functions. Upgrade to one of the following compilers: * ACC 1.56 Beta: DOWNLOAD. This archive also includes the latest Zandronum zcommon from