RU/getZoneName: Difference between revisions

Latest revision as of 09:34, 8 March 2010

Эта функция позволяет вам узнать название территории в определенном месте.

Использование

string getZoneName ( float x, float y, float z, [bool citiesonly=false] )

Необходимые параметры

x: Положение по оси X
y: Положение по оси Y
z: Положение по оси Z

Дополнительные параметры

Примечание. При использовании необязательных аргументов Вам может потребоваться предоставить все аргументы перед тем аргументом, который Вы хотите использовать. Для более подробной информации ознакомьтесь с необязательными аргументами.

citiesonly: Необязательный параметр, который показывает название города(например Лас Вентурас)

Что возвращается

Возвращается string, показывающий название территории.

Примеры

Click to collapse [-]

Сервер

Пример 1: Пример показывает вам, как можно показать название территории при наборе команды /loc x y z в окно чата, или loc x y z в окно консоли.(замените x, y, z координатами , на которых вы хотите проверить территорию, например /loc 1200 523 12.3 )

function playerLoc ( source, command, x, y, z )
  local location = getZoneName ( x, y, z )
  outputChatBox ( "* Location: " .. location, getRootElement(), 0, 255, 255 ) -- вывод названии территории
end
addCommandHandler( "loc", playerLoc )

Пример 2: Этот пример показывает, как узнать название территории, где сейчас находится игрок с помощью команды "getloc", которая вводится в консоль.

function scriptGetLoc ( source, command, playername ) --when getloc is called
  local thePlayer = getPlayerFromNick ( playername ) --показывает игрока по его нику
  if ( thePlayer ~= false ) then --if there is a player from the nickname
    local x, y, z = getElementPosition ( player )
    local location = getZoneName ( x, y, z )
	local city = getZoneName ( x, y, z, true )
    outputChatBox ( playername .. " is at " .. location .. " (" .. city .. ")", source ) --показывает название территории
  else outputChatBox ( "Player does not exist" )
  end
end
addCommandHandler( "getloc", scriptGetLoc ) -- добавляет команду "getloc" которая использует функцию "scriptGetloc"

Смотри также

@@ Line 1: / Line 1: @@
 __NOTOC__
-{{Server client function}}
+{{RU/Server client function}}
-This function allows you to retrieve the zone name of a certain location.
+Эта функция позволяет вам узнать название территории в определенном месте.
-==Syntax==
+==Использование==
 <syntaxhighlight lang="lua">
 string getZoneName ( float x, float y, float z, [bool citiesonly=false] )
 </syntaxhighlight>
-===Required Arguments===
+===Необходимые параметры===
-*'''x:''' The X axis position
+*'''x:''' Положение по оси X
-*'''y:''' The Y axis position
+*'''y:''' Положение по оси Y
-*'''z:''' The Z axis position
+*'''z:''' Положение по оси Z
-===Optional Arguments===
+===Дополнительные параметры===
-{{OptionalArg}}
+{{RU/OptionalArg}}
-* '''citiesonly''': An optional argument to choose if you want to return the city name (eg Las Venturas)
+* '''citiesonly''': Необязательный параметр, который показывает название города(например Лас Вентурас)
-===Returns===
+===Что возвращается===
-Returns the string of the zone name
+Возвращается '''string''', показывающий название территории.
-==Example==
+==Примеры==
-<section name="Server" class="server" show="true">
+<section name="Сервер" class="server" show="true">
-'''Example 1:''' This example shows you how to return a zone name by doing /loc x y z in the chatbox or just loc x y z in console ( replace x, y and z with the co-ords you wanna check, eg /loc 1200 523 12.3 )
+'''Пример 1:''' Пример показывает вам, как можно показать название территории при наборе команды /loc x y z в окно чата, или loc x y z в окно консоли.(замените x, y, z координатами , на которых вы хотите проверить территорию, например /loc 1200 523 12.3 )
 <syntaxhighlight lang="lua">
 function playerLoc ( source, command, x, y, z )
    local location = getZoneName ( x, y, z )
-   outputChatBox ( "* Location: " .. location, getRootElement(), 0, 255, 255 ) -- Output the zone name
+   outputChatBox ( "* Location: " .. location, getRootElement(), 0, 255, 255 ) -- вывод названии территории
 end
 addCommandHandler( "loc", playerLoc )
 </syntaxhighlight>
-'''Example 2:''' This example will tell you what zone a specified player is in when the "getloc" console command is used.
+'''Пример 2:''' Этот пример показывает, как узнать название территории, где сейчас находится игрок с помощью команды "getloc", которая вводится в консоль.
 <syntaxhighlight lang="lua">
 function scriptGetLoc ( source, command, playername ) --when getloc is called
-   local thePlayer = getPlayerFromNick ( playername ) --get the player from nickname
+   local thePlayer = getPlayerFromNick ( playername ) --показывает игрока по его нику
    if ( thePlayer ~= false ) then --if there is a player from the nickname
      local x, y, z = getElementPosition ( player )
      local location = getZoneName ( x, y, z )
 	local city = getZoneName ( x, y, z, true )
-     outputChatBox ( playername .. " is at " .. location .. " (" .. city .. ")", source ) --announce his zone
+     outputChatBox ( playername .. " is at " .. location .. " (" .. city .. ")", source ) --показывает название территории
    else outputChatBox ( "Player does not exist" )
    end
 end
-addCommandHandler( "getloc", scriptGetLoc ) -- add a command "getloc" which initiates "scriptGetloc" function
+addCommandHandler( "getloc", scriptGetLoc ) -- добавляет команду "getloc" которая использует функцию "scriptGetloc"
 </syntaxhighlight>
 </section>
-==See Also==
+==Смотри также==
-{{World functions}}
+{{RU/World functions}}
 [[en:getZoneName]]