Mathf.Clamp
Success!
Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.
Submission failed
For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.
Declaration
Parameters
| value | The floating point value to restrict inside the range defined by the min and max values. |
| min | The minimum floating point value to compare against. |
| max | The maximum floating point value to compare against. |
Returns
float The float result between the min and max values.
Description
Clamps the given value between the given minimum float and maximum float values. Returns the given value if it is within the min and max range.
Returns the min value if the given float value is less than the min. Returns the max value if the given value is greater than the max value. Use Clamp to restrict a value to a range that is defined by the min and max values.
Declaration
Parameters
| value | The integer point value to restrict inside the min-to-max range |
| min | The minimum integer point value to compare against. |
| max | The maximum integer point value to compare against. |
Returns
int The int result between min and max values.
Description
Clamps the given value between a range defined by the given minimum integer and maximum integer values. Returns the given value if it is within min and max.
Returns the min value if the given value is less than the min value. Returns the max value if the given value is greater than the max value. The min and max parameters are inclusive. For example, Clamp(10, 0, 5) will return a maximum argument of 5 and not 4.
Is something described here not working as you expect it to? It might be a Known Issue. Please check with the Issue Tracker at issuetracker.unity3d.com.
Copyright ©2021 Unity Technologies. Publication Date: 2021-11-05.
Mathf.Clamp
Parameters
| value | The floating point value to restrict inside the range defined by the min and max values. |
| min | The minimum floating point value to compare against. |
| max | The maximum floating point value to compare against. |
Returns
float The float result between the min and max values.
Description
Clamps the given value between the given minimum float and maximum float values. Returns the given value if it is within the min and max range.
Returns the min value if the given float value is less than the min. Returns the max value if the given value is greater than the max value. Use Clamp to restrict a value to a range that is defined by the min and max values.
Parameters
| value | The integer point value to restrict inside the min-to-max range |
| min | The minimum integer point value to compare against. |
| max | The maximum integer point value to compare against. |
Returns
int The int result between min and max values.
Description
Clamps the given value between a range defined by the given minimum integer and maximum integer values. Returns the given value if it is within min and max.
Returns the min value if the given value is less than the min value. Returns the max value if the given value is greater than the max value. The min and max parameters are inclusive. For example, Clamp(10, 0, 5) will return a maximum argument of 5 and not 4.
Unity3d. Уроки от Unity 3D Student (B25-B28)
Всем привет. Это заключительная серия базовых уроков по Unity 3D от сайта Unity3DStudent. Далее будут еще два урока среднего уровня. Upd: планы изменились, этих уроков не будет, так как второй урок (по анимации) уже довольно сильно устарел, а выкладывать перевод только одного урока не вижу смысла. Пусть он останется на самостоятельное изучение =)
Базовый урок 25 — Объект GUI Texture и события мыши
В уроке рассказывается о создании простой кнопки, с использованием GUI Texture и событий мыши.
Если вы хотите создать простой пользовательский интерфейс, то можно использовать объект GUI Texture. Рассмотрим этот объект на примере создания кнопки. В первую очередь нам понадобятся две текстуры: для кнопки в обычном состоянии и для кнопки в состоянии, когда на нее наведен курсор мыши. Подготовим соответствующие файлы и добавим их в проект.
Теперь кликнем по файлу button_normal, а затем создадим GUI Texture из меню GameObject — Create Other — GUI Texture. На сцене появиться новый объект, на который будет сразу же наложена соответствующая текстура нормального состояния кнопки.
Созданный объект состоит из двух компонентов: Transform и GUITexture. Обратите внимание, что изменение параметров компонента Transform работает несколько иначе по сравнению с другими объектами сцены. В параметрах Position и Scale обрабатываются только изменения по осям X и Y, изменения по оси Z игнорируются. Изменения параметра Rotation игнорируется полностью. Кроме того, в параметре Position значения указываются не в мировых, а в экранных координатах, где 0,0 — левый нижний угол экрана, а 1,1 — правый верхний угол экрана. По-умолчанию выставляются значения 0.5,0.5, т.е. центр экрана. В компоненте GUITexture можно задать текстуру, цвет, дополнительное смещение от краев экрана и границу. Поскольку мы выбрали конкретную текстуру перед созданием объекта, Unity сама задала эти значения. При желании, их можно изменить.
Итак, у нас есть кнопка в центре экрана, которая пока ничего не делает. Давайте оживим ее при помощи следующего скрипта:
Код на JavaScript:
Мы завели переменные normalTex и hoverTex для хранения, соответственно, текстуры нормального состояния кнопки и текстуры кнопки под курсором мыши. Затем обрабатываем три метода: OnMouseEnter (наведение курсора мышки на объект), OnMouseExit (выход курсора мышки из объекта) и OnMouseDown (клик мышкой по объекту). Эти методы вызываются после соответствующих событий мышки, если объект, к которому присоединен скрипт, унаследован от класса GUIElement или Collider. В методах вхождения/выхода курсора мышки мы устанавливаем объекту соответствующую текстуру, в методе клика просто пишем сообщение в консоль.
Присоединяем скрипт к нашей кнопке, заносим файлы текстур в соответствующие поля:
Запускаем сцену и тестируем кнопку. Кнопка меняет текстуру при наведении курсора мышки, при клике выводит сообщение «clicked» в консоль и меняет текстуру обратно при выводе курсора.
Дополнительные материалы:
Базовый урок 26 — Использование метода Mathf.Clamp для ограничения значений
В уроке показано, как ограничить значения в определенном диапазоне с помощью метода Mathf.Clamp.
При разработке игровой механики иногда нужно ограничить некое значение в пределах заданного интервала значений. Например, вы пишете какую-нибудь простую космическую стрелялку и хотите, чтобы управляемый игроком корабль не вылетал за пределы границ экрана. В этом нам поможет метод Clamp класса Mathf.
Рассмотрим использование этого метода на сцене, где у нас есть камера, источник света и простой кубик Cube.
Мы перемещаем кубик с использованием значения виртуальной оси Х и метода Transform.Translate, а затем ограничиваем позицию кубика по оси Х, вызывая метод Mathf.Clamp. Метод принимает три параметра: ограничиваемое значение, минимальную границу диапазона и максимальную границу диапазона.
Дополнительные материалы:
Базовый урок 27 — Реализация приостановки (паузы) в игре при помощи Time.timeScale
В уроке рассматривается использование свойства Time.timeScale для приостановки/возобновления игры.
Разрабатывая игру, вы наверняка захотите дать игрокам возможность поставить ее на паузу, а потом возобновить. Для этого нужно всего лишь немного поработать со статическим свойством timeScale класса Time.
Для примера, у нас есть сцена, где по полу скачет небольшой шарик, и мы хотим приостанавливать/возобновлять его движение. Сперва нам нужен объект, на который мы «повесим» скрипт реализации паузы. Для этого можно создать пустой игровой объект (меню GameObject — Create Empty), разместить в любом удобном месте и назвать его, например, Manager.
Теперь создадим новый скрипт и напишем в нем следующее:
Код на JavaScript:
В скрипте мы завели переменную paused для контроля, включена пауза или нет. Включение/выключение паузы мы делаем в методе Update по нажатию кнопки «Jump» — при стандартных настройках ввода это клавиша пробела. Далее мы проверяем, выключена ли пауза? Если это так — присваиваем свойству Time.timeScale значение 0, что остановит течение времени в игре; и обозначаем, что пауза включена — paused=true. В противном случае — присваиваем Time.timeScale значение 1 и выключаем паузу. Свойству Time.timeScale также можно устанавливать значения между 0 и 1 и больше 1, что будет, соответственно, замедлять и ускорять течение времени, если вам это нужно.
Добавляем скрипт к объекту Manager, запускаем сцену. В любой момент нажимаем на пробел — шарик останавливается. Повторное нажатие возвращает приостановленное движение шарика.
Дополнительные материалы:
Базовый урок 28 — Использование метода SendMessage для вызова внешних методов
В уроке рассказывается, как использовать метод SendMessage класса GameObject для вызова метода скрипта другого игрового объекта.
Существуют разные способы связаться из скрипта одного игрового объекта со скриптом другого игрового объекта. Ранее мы рассматривали метод GetComponent, с помощью которого можно получить компоненты объекта, в том числе и его скрипты. Альтернативой этому может быть использование метода SendMessage.
Рассмотрим сцену, на которой есть голубой шар Ball, падающий на красный ящик Switch. Рядом с ними висит в воздухе черный блок Block. Давайте сделаем так, чтобы при падании шара на ящик блок менял текстуру и тоже падал вниз.
Сначала нам надо написать скрипт для блока. Создадим новый скрипт, назовем его Reactor и напишем следующее:
Код на JavaScript:
Мы объявили переменную downTexture для хранения текстуры и реализовали метод React, в котором меняем текстуру объекта, делаем небольшую задержку в 1 секунду и добавляем компонент твердого тела Rigidbody, чтобы на объект стала действовать гравитация. Добавим сразу этот скрипт к объекту Block и перетянем в поле скрипта Down Texture любую подходящую картинку. В уроке это изображение направленной вниз желтой стрелки на черном фоне.
Не торопитесь пока запускать сцену, на ней пока что ничего не изменится. Далее нам нужно сделать скрипт для шара Ball. Назовем его Switcher и напишем внутри:
Код на JavaScript:
Мы реализовали метод OnCollisionEnter, который будет вызван при столкновении коллайдера шара с коллайдером другого объекта. Нас интересует столкновение с ящиком Switch, поэтому мы сперва делаем соответствующую проверку. Если это так, мы ищем объект блока Block при помощи метода GameObject.Find, указав имя блока. Для найденного объекта вызывается метод SendMessage, в который передается имя метода, который мы хотим вызвать (React), после чего, соответственно, происходит выполнение этого метода.
Добавляем скрипт к шару, запускаем сцену. Теперь при падении шара на ящик блок меняет текстуру и спустя секунду тоже падает вниз.
Примечание от переводчика: одним из минусов использования SendMessage является возможное ухудшение производительности по сравнению с вызовом методов напрямую. Вот на этой странице, посвященной вопросам производительности, говорится о разнице в 100 раз в пользу прямого вызова. Поэтому применять этот метод следует с осторожностью (как и методы GetComponent, Find и т.п.), и если его использование действительно становится виновником падения производительности — использовать более быстрые решения.
Mathf.Clamp
Success!
Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.
Submission failed
For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.
Parameters
| value | The floating point value to restrict inside the range defined by the min and max values. |
| min | The minimum floating point value to compare against. |
| max | The maximum floating point value to compare against. |
Returns
float The float result between the min and max values.
Description
Clamps the given value between the given minimum float and maximum float values. Returns the given value if it is within the min and max range.
Returns the min value if the given float value is less than the min. Returns the max value if the given value is greater than the max value. Use Clamp to restrict a value to a range that is defined by the min and max values.
Parameters
| value | The integer point value to restrict inside the min-to-max range |
| min | The minimum integer point value to compare against. |
| max | The maximum integer point value to compare against. |
Returns
int The int result between min and max values.
Description
Clamps the given value between a range defined by the given minimum integer and maximum integer values. Returns the given value if it is within min and max.
Returns the min value if the given value is less than the min value. Returns the max value if the given value is greater than the max value. The min and max parameters are inclusive. For example, Clamp(10, 0, 5) will return a maximum argument of 5 and not 4.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
Is something described here not working as you expect it to? It might be a Known Issue. Please check with the Issue Tracker at
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
You’ve told us this page needs code samples. If you’d like to help us further, you could provide a code sample, or tell us about what kind of code sample you’d like to see:
You’ve told us there are code samples on this page which don’t work. If you know how to fix it, or have something better we could use instead, please let us know:
You’ve told us there is information missing from this page. Please tell us more about what’s missing:
You’ve told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You’ve told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You’ve told us there is a spelling or grammar error on this page. Please tell us what’s wrong:
You’ve told us this page has a problem. Please tell us more about what’s wrong:
Thanks for helping to make the Unity documentation better!
Is something described here not working as you expect it to? It might be a Known Issue. Please check with the Issue Tracker at issuetracker.unity3d.com.
Copyright © 2020 Unity Technologies. Publication Date: 2021-02-24.
Mathf.Clamp
Parameters
| value | The floating point value to restrict inside the range defined by the min and max values. |
| min | The minimum floating point value to compare against. |
| max | The maximum floating point value to compare against. |
Returns
float The float result between the min and max values.
Description
Clamps the given value between the given minimum float and maximum float values. Returns the given value if it is within the min and max range.
Returns the min value if the given float value is less than the min. Returns the max value if the given value is greater than the max value. Use Clamp to restrict a value to a range that is defined by the min and max values.
Parameters
| value | The integer point value to restrict inside the min-to-max range |
| min | The minimum integer point value to compare against. |
| max | The maximum integer point value to compare against. |
Returns
int The int result between min and max values.
Description
Clamps the given value between a range defined by the given minimum integer and maximum integer values. Returns the given value if it is within min and max.
Returns the min value if the given value is less than the min value. Returns the max value if the given value is greater than the max value. The min and max parameters are inclusive. For example, Clamp(10, 0, 5) will return a maximum argument of 5 and not 4.
