Nodes/comfyui-AGSoft/🎬 AGSoft LTX Base
ComfyUI Node

🎬 AGSoft LTX Base

AGSoft LTX Base — universal video parameter calculator for LTX models. Automatically normalizes all values to the required formats: • Frame width and height — always multiples of 32. • Frame count — follows the sequence: 1, 9, 17, 25, 33... (N×8+1). • Frame rate (FPS) — integer and float (2 decimal places). Supports three size modes: Preset, Custom, Megapixels. Invert orientation available for Preset and Custom modes. Frame count can be calculated from seconds or entered manually. Use this node before connecting to LTX Video Sampler or other LTX nodes. ═══════════════════════════════════════ AGSoft LTX Base — универсальный калькулятор параметров для моделей LTX. Автоматически нормализует все значения под требования формата: • Ширина и высота кадра — всегда кратны 32. • Количество кадров — последовательность: 1, 9, 17, 25, 33... (N×8+1). • Частота кадров (FPS) — целое и дробное (2 знака после запятой). Три режима выбора размера: Preset, Custom, Megapixels. Инверсия сторон работает в Preset и Custom. Количество кадров — авторасчёт из секунд или ручной ввод. Используйте эту ноду перед подключением к LTX Video Sampler или другим LTX-нодам.

By Art-xmaster·Created 11 months ago·Updated 22 days ago· 20
🎬 AGSoft LTX Base
    • width
    • height
    • frame_rate_int
    • frame_rate_float
    • frame_count
    ◄modePreset►
    ◄preset1280×704 (16:9)►
    ◄invert_orientationfalse►
    ◄custom_width1280►
    ◄custom_height704►
    ◄megapixels_value1.00►
    ◄aspect_ratio16:9►
    ◄frame_rate_float25.00►
    ◄frame_count_sourceFrom seconds►
    ◄length_seconds5►
    ◄frame_count129►
    CategoryAGSoft/Video

    Inputs (11)

    NameTypeDefaultDescription
    modeCOMBOPresetFrame size selection mode. • Preset — choose from 40 predefined sizes grouped by aspect ratio. Aspect ratios: 1:1 (Square), 3:2 (Photo), 4:3 (Standard), 16:9 (Cinema). All sizes are already multiples of 32. Invert orientation supported. • Custom — manually enter width and height in pixels. Values are automatically rounded UP to the nearest multiple of 32. Example: 100×100 → 128×128. Invert orientation supported. • Megapixels — specify target resolution in megapixels + aspect ratio. Width and height calculated automatically, rounded to multiples of 32. Invert orientation NOT applied (aspect ratio defines orientation). ═══════════════════════════════════════ Режим выбора размера кадра. • Preset — выбор из 40 готовых размеров по соотношениям сторон. Форматы: 1:1 (Квадрат), 3:2 (Фото), 4:3 (Стандарт), 16:9 (Кино). Все размеры уже кратны 32. Доступна инверсия сторон. • Custom — ручной ввод ширины и высоты в пикселях. Значения автоматически округляются ВВЕРХ до кратности 32. Пример: 100×100 → 128×128. Доступна инверсия сторон. • Megapixels — задаёте мегапиксели + соотношение сторон. Размеры рассчитываются автоматически, кратность 32 соблюдается. Инверсия НЕ применяется (соотношение уже задаёт ориентацию).
    presetCOMBO1280×704 (16:9)Predefined frame size with aspect ratio label. Format: WIDTH×HEIGHT (ASPECT_RATIO) Examples: • 1024×1024 (1:1) — square, 1 megapixel • 1280×704 (16:9) — HD landscape, cinema format • 768×1344 (9:16) — vertical video (after invert) All sizes are multiples of 32 — safe for LTX models. Grouped by aspect ratio for easy navigation: 1:1 → 3:2 → 4:3 → 16:9 Use 'invert_orientation' to swap width↔height if needed. ═══════════════════════════════════════ Готовый размер кадра с меткой соотношения сторон. Формат: ШИРИНА×ВЫСОТА (СООТНОШЕНИЕ) Примеры: • 1024×1024 (1:1) — квадрат, 1 мегапиксель • 1280×704 (16:9) — HD горизонтальное, киноформат • 768×1344 (9:16) — вертикальное видео (после инверсии) Все размеры кратны 32 — безопасно для моделей LTX. Сгруппированы по соотношениям для удобной навигации: 1:1 → 3:2 → 4:3 → 16:9 Используйте 'invert_orientation' для смены ширины и высоты.
    invert_orientationBOOLEANfalseSwap width and height values. Use cases: • Quickly create vertical video from landscape preset. Example: 1280×704 → 704×1280 (9:16 vertical) • Swap custom dimensions without re-entering values. Works in: Preset and Custom modes. Does NOT work in: Megapixels mode (aspect ratio defines orientation). ═══════════════════════════════════════ Поменять ширину и высоту местами. Сценарии использования: • Быстрое создание вертикального видео из горизонтального пресета. Пример: 1280×704 → 704×1280 (вертикальное 9:16) • Смена размеров без повторного ввода значений. Работает в: Preset и Custom. НЕ работает в: Megapixels (соотношение уже задаёт ориентацию).
    custom_widthINT128064–8192Custom frame width in pixels (used in Custom mode). • Automatically rounded UP to nearest multiple of 32. Example: 100 → 128, 1900 → 1920, 1920 → 1920. • Minimum: 64 pixels. • Maximum: 8192 pixels. • Step: 32 (for convenience). ═══════════════════════════════════════ Своя ширина кадра в пикселях (режим Custom). • Автоматически округляется ВВЕРХ до кратности 32. Пример: 100 → 128, 1900 → 1920, 1920 → 1920. • Минимум: 64 пикселя. • Максимум: 8192 пикселя. • Шаг: 32 (для удобства).
    custom_heightINT70464–8192Custom frame height in pixels (used in Custom mode). • Automatically rounded UP to nearest multiple of 32. Example: 100 → 128, 1080 → 1088, 1088 → 1088. • Minimum: 64 pixels. • Maximum: 8192 pixels. • Step: 32 (for convenience). ═══════════════════════════════════════ Своя высота кадра в пикселях (режим Custom). • Автоматически округляется ВВЕРХ до кратности 32. Пример: 100 → 128, 1080 → 1088, 1088 → 1088. • Минимум: 64 пикселя. • Максимум: 8192 пикселя. • Шаг: 32 (для удобства).
    megapixels_valueFLOAT1.000.1–8Target resolution in megapixels (MP) for Megapixels mode. • 1.0 MP = 1,000,000 pixels (e.g. ~1024×1024). • Range: 0.1 to 8.0 MP. • Step: 0.01 MP (10,000 pixels). • Width and height calculated automatically: – Based on selected aspect_ratio. – Rounded to nearest multiple of 32. Examples: • 0.15 MP + 16:9 → ~512×288 • 1.0 MP + 1:1 → ~1024×1024 • 2.0 MP + 16:9 → ~1920×1088 ═══════════════════════════════════════ Целевое разрешение в мегапикселях (MP) для режима Megapixels. • 1.0 MP = 1 000 000 пикселей (например, ~1024×1024). • Диапазон: 0.1 – 8.0 MP. • Шаг: 0.01 MP (10 000 пикселей). • Ширина и высота рассчитываются автоматически: – На основе выбранного aspect_ratio. – Округляются до кратности 32. Примеры: • 0.15 MP + 16:9 → ~512×288 • 1.0 MP + 1:1 → ~1024×1024 • 2.0 MP + 16:9 → ~1920×1088
    aspect_ratioCOMBO16:9Target aspect ratio for Megapixels mode. Available ratios and typical use: • 1:1 — square, social media (Instagram) • 3:2 — classic photo, 35mm film • 2:3 — vertical photo, portrait • 4:3 — standard monitor, iPad • 3:4 — vertical standard • 16:9 — widescreen, YouTube, TV, cinema • 9:16 — vertical video, Stories, Reels, Shorts • 21:9 — ultrawide, cinematic • 9:21 — vertical ultrawide Final size = closest match to target MP while keeping this ratio. All sizes are multiples of 32. ═══════════════════════════════════════ Целевое соотношение сторон для режима Megapixels. Доступные форматы и их применение: • 1:1 — квадрат, соцсети (Instagram) • 3:2 — классическое фото, 35мм плёнка • 2:3 — вертикальное фото, портрет • 4:3 — стандартный монитор, iPad • 3:4 — вертикальный стандарт • 16:9 — широкий экран, YouTube, ТВ, кино • 9:16 — вертикальное видео, Stories, Reels, Shorts • 21:9 — сверхширокий, кинематографичный • 9:21 — вертикальный сверхширокий Итоговый размер — ближайший к целевому MP при данном соотношении. Все размеры кратны 32.
    frame_rate_floatFLOAT25.000.01–120Frame rate in frames per second (FPS). Standard values: • 23.976 — cinema (NTSC film) • 24.0 — cinema (film standard) • 25.0 — PAL TV (Europe, Russia) • 29.97 — NTSC TV (USA, Japan) • 30.0 — internet video, gaming • 50.0 — smooth motion, slow-mo source • 60.0 — high frame rate, gaming content Two outputs provided: • frame_rate_int — integer part (e.g. 25) • frame_rate_float — full value with 2 decimals (e.g. 25.0, 29.97) Used in frame count calculation: frames = ((sec × FPS_int − 1 + 7) // 8) × 8 + 1 ═══════════════════════════════════════ Частота кадров (FPS). Стандартные значения: • 23.976 — кино (NTSC) • 24.0 — кино (стандарт) • 25.0 — PAL ТВ (Европа, Россия) • 29.97 — NTSC ТВ (США, Япония) • 30.0 — интернет-видео, игры • 50.0 — плавное движение, источник для slow-mo • 60.0 — высокий FPS, игровой контент Два выхода: • frame_rate_int — целая часть (например, 25) • frame_rate_float — полное значение с 2 знаками (например, 25.0, 29.97) Участвует в расчёте кадров: кадры = ((сек × FPS_int − 1 + 7) // 8) × 8 + 1
    frame_count_sourceCOMBOFrom secondsHow to determine the total number of frames. • From seconds — automatic calculation using the formula: ((length_seconds × FPS_int − 1 + 7) // 8) × 8 + 1 Example: 5 sec × 25 FPS = 125 → aligned to 129 frames. The result always follows the sequence: 1, 9, 17, 25, 33... • Manual — you specify the exact frame count. The value is automatically aligned UP to the nearest valid number in the sequence 1, 9, 17, 25... Example: you enter 100 → output will be 105 (nearest 8N+1). HINT: Use 'From seconds' for quick setup. Use 'Manual' for precise control over exact frame count (e.g. for looped animations). ═══════════════════════════════════════ Способ определения общего количества кадров. • From seconds — автоматический расчёт по формуле: ((length_seconds × FPS_int − 1 + 7) // 8) × 8 + 1 Пример: 5 сек × 25 FPS = 125 → выравнивается до 129 кадров. Результат всегда в последовательности: 1, 9, 17, 25, 33... • Manual — вы указываете точное количество кадров. Значение автоматически выравнивается ВВЕРХ до ближайшего допустимого числа в последовательности 1, 9, 17, 25... Пример: вводите 100 → на выходе будет 105 (ближайшее 8N+1). СОВЕТ: используйте 'From seconds' для быстрой настройки. Используйте 'Manual' для точного контроля (например, для зацикленных анимаций).
    length_secondsINT51–3600Desired video duration in seconds. Used ONLY when frame_count_source = 'From seconds'. The actual frame count is calculated as: ((length_seconds × FPS_int − 1 + 7) // 8) × 8 + 1 Examples: • 3 sec × 24 FPS → 71 frames (not 72!) • 5 sec × 25 FPS → 129 frames • 10 sec × 30 FPS → 297 frames Range: 1 to 3600 seconds (1 hour). Note: the output frame count will be slightly different from seconds × FPS due to alignment to the 8N+1 sequence. This is REQUIRED by LTX models. ═══════════════════════════════════════ Желаемая длительность видео в секундах. Используется ТОЛЬКО при frame_count_source = 'From seconds'. Количество кадров рассчитывается по формуле: ((length_seconds × FPS_int − 1 + 7) // 8) × 8 + 1 Примеры: • 3 сек × 24 FPS → 71 кадр (не 72!) • 5 сек × 25 FPS → 129 кадров • 10 сек × 30 FPS → 297 кадров Диапазон: 1 – 3600 секунд (1 час). Заметьте: итоговое число кадров будет немного отличаться от секунды × FPS из-за выравнивания под 8N+1. Это ТРЕБОВАНИЕ моделей LTX.
    frame_countINT1291–99999Exact frame count for Manual mode. Used ONLY when frame_count_source = 'Manual'. The value is automatically aligned UP to the nearest valid number in the LTX sequence: 1, 9, 17, 25, 33, 41, 49, 57, 65, 73, 81, 89, 97... Formula: N × 8 + 1 (where N = 0, 1, 2, 3...) Examples: • You enter: 100 → Output: 105 (nearest 8N+1 >= 100) • You enter: 129 → Output: 129 (already valid) • You enter: 1 → Output: 1 (minimum) • You enter: 200 → Output: 201 (nearest 8N+1 >= 200) Range: 1 to 99999 frames. HINT: Typical LTX videos range from 33 to 257 frames. Common values: 129 (5 sec @25fps), 161, 193. ═══════════════════════════════════════ Точное количество кадров для Manual режима. Используется ТОЛЬКО при frame_count_source = 'Manual'. Значение автоматически выравнивается ВВЕРХ до ближайшего допустимого числа из последовательности LTX: 1, 9, 17, 25, 33, 41, 49, 57, 65, 73, 81, 89, 97... Формула: N × 8 + 1 (где N = 0, 1, 2, 3...) Примеры: • Вводите: 100 → На выходе: 105 (ближайшее 8N+1 >= 100) • Вводите: 129 → На выходе: 129 (уже допустимое) • Вводите: 1 → На выходе: 1 (минимум) • Вводите: 200 → На выходе: 201 (ближайшее 8N+1 >= 200) Диапазон: 1 – 99999 кадров. СОВЕТ: типичные LTX видео — от 33 до 257 кадров. Частые значения: 129 (5 сек @25fps), 161, 193.

    Outputs (5)

    NameTypeDescription
    widthINT—
    heightINT—
    frame_rate_intINT—
    frame_rate_floatFLOAT—
    frame_countINT—