MadMedic sector system v 0.9d

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

Бибилиотечка рапространяется бесплатно. При использовании данного ПО в проекте (или проэкте :) ) необходимо уведомить об этом автора. Размещение данного ПО в в интернете, на любых носителях разрешается только при помещении в архив данной документации и уведомлении об этом автора.

Функции

MMSector_Init(SectorCnt%,DynEntCnt%,UpdateTime%)

Инициализация библиотеки. Обязательно перед работой. Параметры

• SectorCnt% - Предполагаемое количество секторов в системе. При превышении данного числа будет ошибка, поэтому организуйте с запасом.
• DynEntCnt% - Предполагаемое количество динамических ентити в системе. При превышении данного числа будет ошибка, поэтому организуйте с запасом.
• UpdateTime% - время обновления. Нормальное значение 100 мс, можно и больше.

MMSector_AddSector%(x#,y#,z#,xs#,ys#,zs#)

Добавить сектор в форме коробки с размерами xs,ys,zs в позицию x,y,z. Возвращает хендл сектора. Параметры:

• x# y# z# - позиция
• xs# ys# zs# - размеры

MMSector_Connect(SectorHandle1%,SectorHandle2%)

Связать один сектор с другим. То есть после этой команды содержимое сектора SectorHandle2 будет видно когда камера находится в секторе SectorHandle1. Этой функцией создается односторонняя связь. Чтобы оба сектора были "взаимовидимы" нужно выполнить как MMSector_Connect(SectorHandle1%,SectorHandle2%), так и MMSector_Connect(SectorHandle2%,SectorHandle1%). Параметры:

• SectorHandle1% - хендл первого сектора
• SectorHandle2% - хендл второго сектора

MMSector_AddStatic(SectorHandle%,Entity%)

Связать с существующим сектором статичную ентити, например, меш ландшафта.Ентити будет автоматически показываться или скрываться в зависимости от того, находится ли она в видимом секторе или нет. Параметры:

• SectorHandle% - хендл сектора
• Entity% - присоединяемая ентити.

MMSector_AddDynamic(Entity%)

Связать с системой секторов динамическую, движимую ентити, например, модель монстра или автомобиль. Ентити будет автоматически показываться или скрываться в зависимости от того, находится ли она в видимом секторе или нет. Параметры:

• Entity% - присоединяемая ентити.

MMSector_Update%(Camera%,Immediately%)

Обновление системы порталов. Функция возвращает хендл сектора, в котором находится камера. Параметры:

• Camera% - камера, относительно которой обновлять порталы.
• Immediately% - при Immediately=1 обновление происходит в любом случае, кроме выключенной системы. С Immediately=1 нужно обновлять перед началом игры или при резкой смене местоположения камеры, чтобы не просиходило постепенного появления сцены.

MMSector_SetEnable(Enable%,DrawStatic%,DrawDynamic%)

Включение/выключение системы секторов. Параметры:

• Enable% - '0' - выключить, '1' - включить
• DrawStatic% - Что сделать со отбражением статических ентити после выключения системы: '0' - спрятать всё, '1' - показать всё, '-1' - оставить как есть.
• DrawDynamic% - Что сделать со отбражением динамических ентити после выключения системы: '0' - спрятать всё, '1' - показать всё, '-1' - оставить как есть.

MMSector_SetPos(SectorHandle%,x#,y#,z#)

Изменить координаты сектора. Параметры:

• SectorHandle% - хендл сектора
• x# y# z# - новые координаты

MMSector_SetSize(SectorHandle%,xs#,ys#,zs#)

Изменить размеры сектора. Параметры:

• SectorHandle% - хендл сектора
• xs# ys# zs# - новые размеры

MMSector_DetachDynamic(Entity%,Draw%)

Отсоединить от секторной системы данную динамическую ентити. Параметры:

• Entity% - ентити, ранее подсоединенная функцией MMSector_AddDynamic()
• Draw% - Что сделать со отбражением динамических ентити после отсединения от системы: '0' - спрятать , '1' - показать , '-1' - оставить как есть.

MMSector_DetachStatic(SectorHandle%,Entity%,Draw%)

Отсоединить от сектора данную статическую ентити, если такая есть. Параметры:

• SectorHandle% - хендл сектора
• Entity% - ентити, ранее подсоединенная функцией MMSector_AddStatic()
• Draw% - Что сделать со отбражением динамических ентити после отсединения от системы: '0' - спрятать , '1' - показать , '-1' - оставить как есть.

MMSector_ClearDynamic(Draw%)

Отсоединить от секторной системы все динамические ентити. Параметры:

• Draw% - Что сделать со отбражением динамических ентити после отсединения от системы: '0' - спрятать , '1' - показать , '-1' - оставить как есть.

MMSector_ClearStatic(SectorHandle%,Draw%)

Отсоединить от данного сектора все статические ентити, если такая есть. Параметры:

• SectorHandle% - хендл сектора
• Draw% - Что сделать со отбражением динамических ентити после отсединения от системы: '0' - спрятать , '1' - показать , '-1' - оставить как есть.

MMSector_Free(DrawStatic%,DrawDynamic%)

Удаление системы секторов. Параметры:

• DrawStatic% - Что сделать со отбражением статических ентити после удаления системы: '0' - спрятать всё, '1' - показать всё, '-1' - оставить как есть.
• DrawDynamic% - Что сделать со отбражением динамических ентити после удаления системы: '0' - спрятать всё, '1' - показать всё, '-1' - оставить как есть.

По всем вопросам, замечаниям, предложениям и с благодарностями обращаться по e-mail: MadMedic@rambler.ru