150 lines
6.9 KiB
Markdown
150 lines
6.9 KiB
Markdown
|
# Конфигурация системы коллайдеров
|
|||
|
|
|
|||
|
|
## Обзор изменений
|
|||
|
|
|
|||
|
|
Система коллайдеров была обновлена для обеспечения полного покрытия объектов коллизиями. Теперь коллайдеры создаются с увеличенными размерами, чтобы покрывать весь объект, а не только его часть.
|
|||
|
|
|
|||
|
|
## Основные изменения
|
|||
|
|
|
|||
|
|
### 1. Конфигурация коллайдеров
|
|||
|
|
```javascript
|
|||
|
|
const COLLIDER_CONFIG = {
|
|||
|
|
sizeMultiplier: 2.0, // Коэффициент увеличения размеров (100% больше)
|
|||
|
|
debugMode: false, // Режим отладки для визуализации
|
|||
|
|
minSize: 0.5, // Минимальный размер коллайдера
|
|||
|
|
maxSize: 50.0, // Максимальный размер коллайдера
|
|||
|
|
adaptiveScaling: true // Адаптивное масштабирование
|
|||
|
|
};
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. Обновленная функция создания коллайдеров
|
|||
|
|
- `createVisualColliderFromModel()` теперь использует увеличенные размеры для JSON данных
|
|||
|
|
- Приоритет отдается реальным размерам мешей из 3D модели
|
|||
|
|
- Fallback к JSON данным с коэффициентом увеличения
|
|||
|
|
|
|||
|
|
### 3. Адаптивное масштабирование
|
|||
|
|
Система автоматически определяет оптимальный коэффициент масштабирования на основе размеров объекта:
|
|||
|
|
- **Маленькие объекты** (< 1.0): коэффициент 3.0x или больше
|
|||
|
|
- **Средние объекты** (1.0-5.0): стандартный коэффициент 2.0x
|
|||
|
|
- **Большие объекты** (> 5.0): уменьшенный коэффициент 1.6x
|
|||
|
|
|
|||
|
|
### 4. Динамическая настройка
|
|||
|
|
Добавлены расширенные функции для настройки коллайдеров:
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
// Изменить коэффициент размера коллайдеров
|
|||
|
|
window.updateColliderSize(3.0); // Увеличить на 200%
|
|||
|
|
|
|||
|
|
// Переключить адаптивное масштабирование
|
|||
|
|
window.toggleAdaptiveScaling();
|
|||
|
|
|
|||
|
|
// Установить ограничения размеров
|
|||
|
|
window.setColliderLimits(1.0, 20.0); // мин: 1.0, макс: 20.0
|
|||
|
|
|
|||
|
|
// Переключить режим отладки
|
|||
|
|
window.toggleColliderDebug();
|
|||
|
|
|
|||
|
|
// Получить текущую конфигурацию
|
|||
|
|
console.log(window.colliderConfig);
|
|||
|
|
|
|||
|
|
// Протестировать коллизии
|
|||
|
|
window.testCollisions();
|
|||
|
|
|
|||
|
|
// Быстрый тест всех функций
|
|||
|
|
window.quickTest();
|
|||
|
|
|
|||
|
|
// Управление цветом и прозрачностью коллайдеров
|
|||
|
|
window.setColliderColor(0, 1, 0); // Зеленый цвет (RGB 0-1)
|
|||
|
|
window.setColliderOpacity(0.5); // Полупрозрачность (0-1)
|
|||
|
|
window.randomizeColliderColors(); // Случайные цвета
|
|||
|
|
|
|||
|
|
// Управление цветом и прозрачностью объектов интерьера
|
|||
|
|
window.setInteriorObjectColor(1, 0, 0); // Красный цвет объектов (RGB 0-1)
|
|||
|
|
window.setInteriorObjectOpacity(0.7); // Полупрозрачность объектов (0-1)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Использование
|
|||
|
|
|
|||
|
|
### Базовое использование
|
|||
|
|
Коллайдеры автоматически загружаются из `colliders_city_1.json` с увеличенными размерами.
|
|||
|
|
|
|||
|
|
### Настройка размеров
|
|||
|
|
Если коллайдеры слишком большие или маленькие, можно изменить коэффициент:
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
// В консоли браузера
|
|||
|
|
window.updateColliderSize(1.0); // Оригинальные размеры
|
|||
|
|
window.updateColliderSize(1.2); // +20% (по умолчанию)
|
|||
|
|
window.updateColliderSize(1.5); // +50%
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Отладка
|
|||
|
|
Для визуализации коллайдеров включите режим отладки:
|
|||
|
|
```javascript
|
|||
|
|
window.colliderConfig.debugMode = true;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Технические детали
|
|||
|
|
|
|||
|
|
### Алгоритм создания коллайдеров
|
|||
|
|
1. Поиск соответствующего меша в 3D модели по позиции
|
|||
|
|
2. Если меш найден - использование его реальных размеров
|
|||
|
|
3. Если меш не найден - использование JSON данных с коэффициентом увеличения
|
|||
|
|
4. Создание Box3 для проверки коллизий
|
|||
|
|
5. Создание визуального представления
|
|||
|
|
|
|||
|
|
### Проверка коллизий
|
|||
|
|
- Используется AABB (Axis-Aligned Bounding Box) для эффективной проверки
|
|||
|
|
- Игрок представлен как цилиндр с радиусом 0.35 и высотой 1.6
|
|||
|
|
- Проверка пересечения Box3 объектов
|
|||
|
|
|
|||
|
|
## Файлы конфигурации
|
|||
|
|
|
|||
|
|
### colliders_city_1.json
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"colliders": [
|
|||
|
|
{
|
|||
|
|
"type": "box",
|
|||
|
|
"position": { "x": 0, "y": 0, "z": 0 },
|
|||
|
|
"rotation": { "x": 0, "y": 0, "z": 0 },
|
|||
|
|
"scale": { "x": 2, "y": 2, "z": 2 },
|
|||
|
|
"color": { "r": 1.0, "g": 0.0, "b": 0.0 },
|
|||
|
|
"opacity": 0.3
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Параметры:**
|
|||
|
|
- `position`, `rotation`, `scale` - стандартные параметры трансформации
|
|||
|
|
- `color` - RGB цвет в диапазоне 0.0-1.0 (опционально)
|
|||
|
|
- `opacity` - прозрачность в диапазоне 0.0-1.0 (опционально)
|
|||
|
|
|
|||
|
|
Размеры в JSON будут автоматически увеличены на коэффициент `sizeMultiplier`.
|
|||
|
|
|
|||
|
|
## Рекомендации
|
|||
|
|
|
|||
|
|
1. **Начальная настройка**: Используйте коэффициент 1.2 (20% увеличение)
|
|||
|
|
2. **Тонкая настройка**: Тестируйте разные значения от 1.0 до 1.5
|
|||
|
|
3. **Отладка**: Включите `debugMode` для визуальной проверки коллайдеров
|
|||
|
|
4. **Производительность**: Большие коэффициенты могут снизить производительность
|
|||
|
|
|
|||
|
|
## Устранение неполадок
|
|||
|
|
|
|||
|
|
### Коллайдеры слишком маленькие
|
|||
|
|
```javascript
|
|||
|
|
window.updateColliderSize(1.3); // Увеличить коэффициент
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Коллайдеры слишком большие
|
|||
|
|
```javascript
|
|||
|
|
window.updateColliderSize(1.1); // Уменьшить коэффициент
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Проблемы с производительностью
|
|||
|
|
```javascript
|
|||
|
|
window.updateColliderSize(1.0); // Вернуться к оригинальным размерам
|
|||
|
|
```
|
|||
|
|
|