Rustext

https://github.com/ziggi/rustext
Admin
Rustext is a plugin for SA-MP that fixes Russian text display in GameText's, TextDraw's, and Menu's,...
Tokens:1,674
Snippets:18
Trust Score:8
License:MIT
Update:4 months ago
Show doc for...
Tokens:
Raw
### Player Russifier Setup Script

Source: https://github.com/ziggi/rustext/blob/master/README.md

This script demonstrates how to initialize and manage player-specific russifier types using TextDraws. It shows how to set the player's russifier, display selectable TextDraws, and handle player clicks to change the russifier.

```Pawn
#include <a_samp>
#include <rustext>

static
	TextRusTD[RussifierType];

const
	Float:TEXT_BASE_X = 150.0,
	Float:TEXT_BASE_Y = 150.0,
	TEXT_RUSSIFIERS_COUNT = 7; // only Russian localizations

public OnGameModeInit()
{
	for (new i; i < TEXT_RUSSIFIERS_COUNT; i++) {
		TextRusTD[RussifierType:i] = _:TextDrawCreate(TEXT_BASE_X,
		                                              TEXT_BASE_Y + 15.0 * i,
		                                              "Я могу прочитать этот текст, это мой русификатор");
		TextDrawSetSelectable(Text:TextRusTD[RussifierType:i], 1);
		TextDrawTextSize(Text:TextRusTD[RussifierType:i], 600.0, 10.0);
	}
	return 1;
}

public OnPlayerSpawn(playerid)
{
	for (new i; i < TEXT_RUSSIFIERS_COUNT; i++) {
		SetPlayerRussifierType(playerid, RussifierType:i);
		TextDrawShowForPlayer(playerid, Text:TextRusTD[RussifierType:i]);
	}
	SelectTextDraw(playerid, 0xAA3333FF);
	return 1;
}

public OnPlayerClickTextDraw(playerid, Text:clickedid)
{
	for (new i; i < TEXT_RUSSIFIERS_COUNT; i++) {
		if (TextRusTD[RussifierType:i] == _:clickedid) {
			SetPlayerRussifierType(playerid, RussifierType:i);
			CancelSelectTextDraw(playerid);
		}
		TextDrawHideForPlayer(playerid, Text:TextRusTD[RussifierType:i]);
	}
	return 0;
}

```

--------------------------------

### rustext Native Functions

Source: https://github.com/ziggi/rustext/blob/master/README.md

Lists the available native functions for interacting with the rustext plugin, including getting version and text, setting and getting player russifier types, and setting/getting the default russifier type.

```Pawn
native GetRussifierVersion(version[], const size = sizeof(version));
native GetRussifierText(RussifierType:type, string[], string_return[], const size = sizeof(string_return));

native SetPlayerRussifierType(playerid, RussifierType:type);
native RussifierType:GetPlayerRussifierType(playerid);

native SetDefaultRussifierType(RussifierType:type);
native RussifierType:GetDefaultRussifierType();

```

--------------------------------

### Build rustext from Source

Source: https://github.com/ziggi/rustext/blob/master/README.md

Instructions for cloning the rustext repository and building the plugin using CMake and Make on a Linux-like system.

```bash
git clone https://github.com/ziggi/rustext.git
mkdir build
cd build
cmake ..
make

```

--------------------------------

### Build rustext with Visual Studio

Source: https://github.com/ziggi/rustext/blob/master/README.md

Instructions for cloning the rustext repository and building the plugin using CMake with the Visual Studio generator.

```bash
cd rustext
mkdir build
cd build
cmake .. -G "Visual Studio 12"

```

--------------------------------

### Include CMake Configuration Files

Source: https://github.com/ziggi/rustext/blob/master/CMakeLists.txt

Includes external CMake configuration files. 'AMXConfig' and 'AddSAMPPlugin' are likely custom modules providing specific build functionalities.

```cmake
include (AMXConfig)
include (AddSAMPPlugin)
```

--------------------------------

### Project and Plugin Version Configuration

Source: https://github.com/ziggi/rustext/blob/master/CMakeLists.txt

Defines the project name and sets a specific version for the plugin. This information is used throughout the build process and can be embedded in the final artifact.

```cmake
project (rustext)
set (PLUGIN_VERSION "2.0.11")
```

--------------------------------

### Configure Shared Library Prefix

Source: https://github.com/ziggi/rustext/blob/master/CMakeLists.txt

Sets the prefix for shared libraries. An empty prefix means the library will not have a platform-specific prefix (e.g., 'lib' on Linux).

```cmake
set (CMAKE_SHARED_LIBRARY_PREFIX "")
```

--------------------------------

### Define Include Directories

Source: https://github.com/ziggi/rustext/blob/master/CMakeLists.txt

Sets the directories that the compiler should search for header files. This is crucial for resolving dependencies during compilation.

```cmake
include_directories (
	${CMAKE_CURRENT_SOURCE_DIR}/
	${CMAKE_CURRENT_SOURCE_DIR}/src
	${CMAKE_CURRENT_SOURCE_DIR}/lib
	${CMAKE_CURRENT_SOURCE_DIR}/lib/sdk
	${CMAKE_CURRENT_SOURCE_DIR}/lib/sdk/amx
)
```

--------------------------------

### Add Compiler Definitions

Source: https://github.com/ziggi/rustext/blob/master/CMakeLists.txt

Adds preprocessor definitions that will be available to the compiler. These are used to conditionally compile code or define constants like plugin name and version.

```cmake
add_definitions (-DPLUGIN_NAME="${PROJECT_NAME}" -DPLUGIN_VERSION="${PLUGIN_VERSION}")
```

--------------------------------

### Add SAMP Plugin Target

Source: https://github.com/ziggi/rustext/blob/master/CMakeLists.txt

Defines the main build target for the SAMP plugin. It lists all the source files, including SDK components, RakNet, and project-specific source files, that constitute the plugin.

```cmake
add_samp_plugin (${PROJECT_NAME}
	lib/sdk/amxplugin.cpp
	lib/sdk/amxplugin2.cpp
	lib/RakNet/BitStream.cpp
	src/main.cpp
	src/main.hpp
	src/natives.cpp
	src/natives.hpp
	src/converter.cpp
	src/converter.hpp
	src/russifier.cpp
	src/russifier.hpp
	src/hooks.cpp
	src/hooks.hpp
	src/common.hpp
	src/exports.def
)
```

--------------------------------

### Set Minimum CMake Version

Source: https://github.com/ziggi/rustext/blob/master/CMakeLists.txt

Specifies the minimum required version of CMake for this project. Ensures compatibility with required CMake features.

```cmake
cmake_minimum_required (VERSION 2.8...9.9)
```

--------------------------------

### Set C++ Standard for GCC/Clang

Source: https://github.com/ziggi/rustext/blob/master/CMakeLists.txt

Configures the C++ standard to C++11 for GCC and Clang compilers. This ensures modern C++ features can be used.

```cmake
if (CMAKE_COMPILER_IS_GNUCXX OR CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
	set (CMAKE_CXX_FLAGS "-std=c++11")
endif ()
```

--------------------------------

### Add CMake Module Path

Source: https://github.com/ziggi/rustext/blob/master/CMakeLists.txt

Appends the 'cmake' directory from the current source directory to the CMake module path. This allows CMake to find custom modules included later in the file.

```cmake
list (APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake)
```

--------------------------------

### RussifierType Enum Definition

Source: https://github.com/ziggi/rustext/blob/master/README.md

Defines the available types of russifiers that can be used with the rustext plugin. Includes disabled, various specific types, and unknown placeholders.

```Pawn
enum RussifierType {
	RussifierType_Disabled = -1,
	RussifierType_SanLtd = 0,
	RussifierType_OneC,
	RussifierType_Rush,
	RussifierType_Unknown1,
	RussifierType_Unknown2,
	RussifierType_Unknown3,
	RussifierType_MG,
	RussifierType_Community,
	RussifierType_Ukraininan,
	RussifierType_Hungarian,
}

```
Tokens:
Raw