SetObjectMaterialText

Iš GTA-Online Wikipedia.
Peršokti į: navigaciją, paiešką

SetObjectMaterialText

Funkcijos pavadinimas SetObjectMaterialText
Sintaksė
Reikalavimai nėra
Kategorija Objektų Funkcijos.png Objektų Funkcijos
Biblioteka a_objects.inc
Atsiradimas 0.3e RC7
Pakeitimai 0.3e RC7-2, 0.3e RC7-3

Aprašymas

Funkcija skirta pakeisti objekto išvaizdą, nustatant tekstūrų raštą norimu tekstu. Galimi tekstūrų matmenys:

ID Priskirta reikšmė Paaiškinimas
10 OBJECT_MATERIAL_SIZE_32x32 Tekstūros aukštis - 32px, plotis - 32px.
20 OBJECT_MATERIAL_SIZE_64x32 Tekstūros aukštis - 32px, plotis - 64px.
30 OBJECT_MATERIAL_SIZE_64x64 Tekstūros aukštis - 64px, plotis - 64px.
40 OBJECT_MATERIAL_SIZE_128x32 Tekstūros aukštis - 32px, plotis - 128px.
50 OBJECT_MATERIAL_SIZE_128x64 Tekstūros aukštis - 64px, plotis - 128px.
60 OBJECT_MATERIAL_SIZE_128x128 Tekstūros aukštis - 128px, plotis - 128px.
70 OBJECT_MATERIAL_SIZE_256x32 Tekstūros aukštis - 32px, plotis - 256px.
80 OBJECT_MATERIAL_SIZE_256x64 Tekstūros aukštis - 64px, plotis - 256px.
90 OBJECT_MATERIAL_SIZE_256x128 Tekstūros aukštis - 128px, plotis - 256px.
100 OBJECT_MATERIAL_SIZE_256x256 Tekstūros aukštis - 256px, plotis - 256px.
110 OBJECT_MATERIAL_SIZE_512x64 Tekstūros aukštis - 64px, plotis - 512px.
120 OBJECT_MATERIAL_SIZE_512x128 Tekstūros aukštis - 128px, plotis - 512px.
130 OBJECT_MATERIAL_SIZE_512x256 Tekstūros aukštis - 256px, plotis - 512px.
140 OBJECT_MATERIAL_SIZE_512x512 Tekstūros aukštis - 512px, plotis - 512px.

Galimos teksto, vaizduojamo tekstūroje, lygiuotės:

ID Priskirta reikšmė Paaiškinimas
0 OBJECT_MATERIAL_TEXT_ALIGN_LEFT Tekstas lygiuojamas pagal kairįjį kraštą.
1 OBJECT_MATERIAL_TEXT_ALIGN_CENTER Tekstas lygiuojamas centre.
2 OBJECT_MATERIAL_TEXT_ALIGN_RIGHT Tekstas lygiuojamas pagal dešinįjį kraštą.

Sintaksė

(objectid, text[], materialindex = 0, materialsize = OBJECT_MATERIAL_SIZE_256x128, fontface[] = "Arial", fontsize = 24, bold = 1, fontcolor = 0xFFFFFFFF, backcolor = 0, textalignment = 0)

Privalomi parametrai

Šis parametras yra privalomas.objectid Objekto, kurio išvaizda keičiama, ID.
Šis parametras yra privalomas.text[] Nustatomo teksto reikšmė.

Neprivalomi parametrai

Šis parametras nėra privalomas.materialindexNustatomos tekstūros numeris. Numatytoji reikšmė 0.
Šis parametras nėra privalomas.materialsizePritaikomos tekstūros dydis. Galimos reikšmės nurodytos aukščiau esančioje lentelėje. Numatytoji reikšmė OBJECT_MATERIAL_SIZE_256x128.
Šis parametras nėra privalomas.fontfaceNustatomo teksto šriftas. Numatytoji reikšmė „Arial“.
Šis parametras nėra privalomas.fontsizeNustatomo teksto dydis. Maksimali parametro reikšmė - 255. Numatytoji reikšmė 24.
Šis parametras nėra privalomas.boldNustatomo teksto paryškinimas. Nustačius šią reikšmę į 1 - tekstas bus paryškintas, 0 - ne. Numatytoji reikšmė 1 (paryškintas).
Šis parametras nėra privalomas.fontcolorNustatomo teksto spalva. Numatytoji reikšmė 0xFFFFFFFF (balta).
Šis parametras nėra privalomas.backcolorNustatomo teksto fono spalva. Numatytoji reikšmė 0 (permatoma).
Šis parametras nėra privalomas.textalignmentNustatomo teksto lygiuotė. Galimos reikšmės nurodytos aukščiau esančioje lentelėje. Numatytoji reikšmė 0 (lygiavimas pagal kairįjį kraštą).


Grąžinama reikšmė:
Ši funkcija neturi grąžinamos reikšmės.

Pavyzdys

Teksto pridėjimas į objekto išvaizdą

Komanda, kuria sukuriamas globalus objektas bei pakeičiama jo tekstūra, į tam tikrą tekstą.

Blantas 21:05, 19 gegužės 2012 (EEST)

public OnPlayerCommandText(playerid, cmdtext[])
{
        if(strcmp("/tekstas", cmdtext, true) == 0)
        {
                new objektas = CreateObject(19353, 0, 0, 10, 0.0, 0.0, 90.0); // Sukuriamas objektas

                SetObjectMaterialText(objektas, "SA-MP {FFFFFF}0.3{008500}e", 0, OBJECT_MATERIAL_SIZE_256x128,
                        "Arial", 28, 0, 0xFFFF8200, 0xFF000000, OBJECT_MATERIAL_TEXT_ALIGN_CENTER);
                // Pakeičiama objekto tekstūra tekstu „SA-MP 0.3e“

                return 1;
        }      
        return 0;
}

Istorija

Release Candidate
0.3e RC7 Pridėta galimybė pakeisti objekto tekstūras norimu tekstu.
0.3e RC7-2 Ištaisyta klaida, dėl kurios, konkretaus objekto pakeistos tekstūros buvo pritaikomos visiems to pačio modelio objektams.
0.3e RC7-3 Ištaisyta klaida, dėl kurios, objekto tekstūros pakeitimas tekstu nebuvo galimas su tam tikromis tekstūrų fono reikšmėmis.

Rekomenduojama

Siūlome patikrinti žemiau išvardintas funkcijas, kurios susijusios su SetObjectMaterialText veikimu.

Globalūs objektai
  • CancelEdit: Nutraukti objekto redagavimo rėžimą.
  • EditObject: Leisti žaidėjui redaguoti globalų objektą.
  • GetObjectPos: Išgauti globalaus objekto pozicijos koordinates.
  • GetObjectRot: Išgauti globalaus objekto pasisukimo laipsnius.
  • MoveObject: Judinti globalų objektą į naują poziciją.
  • SetObjectMaterialText: Pakeisti objekto tekstūras tekstu.
  • SetObjectRot: Nustatyti globalaus objekto pasisukimo laipsnius.
  • StopObject: Sustabdyti judantį globalų objektą.
Žaidėjų objektai

Serverio iškviečiamos funkcijos
  • OnObjectMoved: Iškviečiama globaliam objektui baigus judėti.
Asmeniniai įrankiai
San Andreas Multiplayer