🔧 OPENRNDR 시작하기

윈도우 11 환경에서 IntelliJ IDEA를 활용해 OPENRNDR 개발 환경을 구축하는 과정입니다.

템플릿 Repository를 가져와 Gradle이 빌드하는 방식

OPENRNDR는 Kotlin 및 JVM 기반 프레임워크이므로, 별도로 수동 빌드 설정을 할 필요 없이 공식 제공 라이브러리 템플릿 Repository를 가져와 Gradle이 빌드하도록 구성하는 방식이 가장 효율적입니다.

1. 사전 준비 (선택사항)

• Git 설치: 템플릿 프로젝트를 가져오기 위해 Git이 설치되어 있지 않다면 Official Git 페이지에서 Windows용 64-bit 설치 파일을 다운로드하여 기본 옵션으로 설치합니다.
• JDK (Java Development Kit): IntelliJ가 자체 부bundled JDK를 내장하고 있으므로, 시스템에 JDK가 미리 설치되어 있지 않아도 진행 가능합니다.

2. IntelliJ IDEA 설치

1. JetBrains 공식 홈페이지에서 IntelliJ IDEA Community Edition(무료) 또는 Ultimate Edition 다운로드 파일(.exe)을 실행합니다.
2. 설치 옵션 중 Add "bin" folder to the PATH 항목을 체크해 두면 환경변수가 자동 설정되어 추후 구성에 용이합니다.

3. OPENRNDR 템플릿 저장소 클론 (Clone)

OPENRNDR 공식 템플릿에는 필수 Gradle 설정과 기본 의존성이 미리 구성되어 있습니다.

1. IntelliJ IDEA 실행 후 초기 화면에서 Clone Repository 버튼을 클릭합니다. (이미 프로젝트가 열려 있다면 File > New > Project from Version Control... 선택)
2. URL란에 다음 공식 템플릿 주소를 입력합니다:

https://github.com/openrndr/openrndr-template.git

3. 로컬 저장 디렉터리를 지정한 후 Clone을 누릅니다.

4. Gradle 의존성 동기화 및 JDK 설정

1. 프로젝트가 열리면 오른쪽 하단 상태 표시줄에서 Gradle이 필요한 의존성(OPENRNDR 라이브러리, Kotlin SDK 등)을 자동으로 다운로드하기 시작합니다. (최초 실행 시 1~3분 정도 소요될 수 있습니다)
2. SDK 설정 필요 메시지가 나타나거나 Build Gradle 실패가 뜰 경우:

• File > Project Structure > Project 이동
• SDK 항목에서 Download JDK를 선택하여 Amazon Corretto 17 또는 Oracle OpenJDK 17/21 버전을 다운로드 및 지정합니다.

3. IntelliJ 오른쪽 상단의 Gradle 탭 (코끼리 아이콘)을 열어 Reload All Gradle Projects 버튼을 눌러 동기화를 완료합니다.

5. 기본 템플릿 실행 확인

1. 왼쪽 Project Explorer에서 아래 경로의 파일로 이동합니다:
   src/main/kotlin/TemplateProgram.kt
2. 파일 내부 코드 구조를 확인합니다:

import org.openrndr.application
import org.openrndr.color.ColorRGBa

fun main() = application {
    configure {
        width = 640
        height = 480
    }
    program {
        extend {
            drawer.clear(ColorRGBa.PINK)
        }
    }
}

3. fun main() 코드 줄 바로 옆에 표시되는 초록색 재생 삼각 버튼(▶)을 클릭하고 Run 'TemplateProgramKt'를 선택합니다.
4. 분홍색(PINK) 바탕의 640x480 창이 정상적으로 렌더링되면 윈도우 11 환경 구축이 완료된 것입니다.

💡 팁: ORX (OPENRNDR Extensions) 사용하기

추가 그래픽 기능, 물리 연산, UI 패널, 라이브 코딩(orx-olive) 기능을 활용하려면 프로젝트 루트의 build.gradle.kts 파일을 열고 주석 처리되어 있는 orxFeatures 항목의 주석을 해제한 후 Gradle Sync를 진행하면 됩니다.

최소 의존성만 수동 추가하여 가볍게 시작하기

템플릿 저장소를 클론하지 않고 기존 IntelliJ 프로젝트나 새 Kotlin 프로젝트에 OPENRNDR 라이브러리 최소 의존성만 수동 추가하여 가볍게 시작하는 방법입니다.

OPENRNDR는 C++ 네이티브 그래픽 라이브러리(LWJGL 등)를 포함하므로, Gradle 설정 파일(build.gradle.kts)에 중앙 리포지토리와 최소 의존성 3개(core, application, native binaries)만 명시해 주면 됩니다.

1. IntelliJ에서 새 Kotlin 프로젝트 생성

1. IntelliJ IDEA 실행 후 New Project 클릭
2. 왼쪽 메뉴에서 Kotlin 선택
3. 설정값 지정:

• Name: 프로젝트 이름 (예: openrndr-quickstart)
• Build system: Gradle 선택
• Gradle DSL: Kotlin (build.gradle.kts) 선택
• JDK: 17 이상 선택 (없으면 Download JDK로 바로 설치)

4. Create 버튼 클릭

2. build.gradle.kts 파일 설정

프로젝트 루트 디렉터리의 build.gradle.kts 파일을 열고 기존 내용을 아래와 같이 교체합니다.

plugins {
    kotlin("jvm") version "1.9.22"
    application
}

repositories {
    mavenCentral()
    maven("https://maven.openrndr.org")
}

// OPENRNDR 버전 및 플랫폼 설정
val openrndrVersion = "0.4.3-RELEASE"
val openrndrOs = "windows"

dependencies {
    // 코어 라이브러리
    implementation("org.openrndr:openrndr-core:$openrndrVersion")
    implementation("org.openrndr:openrndr-application:$openrndrVersion")
    implementation("org.openrndr:openrndr-color:$openrndrVersion")
    
    // 윈도우 11 64bit 네이티브 바인딩
    runtimeOnly("org.openrndr:openrndr-gl3-natives-\(openrndrOs:\)openrndrVersion")
    runtimeOnly("org.openrndr:openrndr-openal-natives-\(openrndrOs:\)openrndrVersion")
    
    // Kotlin 표준 라이브러리 및 코루틴 support
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
}

application {
    mainClass.set("MainKt")
}

파일 편집 후 IntelliJ 우측 상단에 뜨는 Gradle 동기화 아이콘(코끼리 모양 버튼)**을 누르거나 Ctrl + Shift + O를 눌러 변경사항을 적용합니다.

3. 메인 소스 코드 작성

1. src/main/kotlin/ 경로에 Main.kt 파일을 생성합니다.
2. 아래 코드를 입력합니다.

import org.openrndr.application
import org.openrndr.color.ColorRGBa

fun main() = application {
    configure {
        width = 800
        height = 600
        title = "OPENRNDR Light Setup"
    }
    program {
        extend {
            // 배경색 설정 (R, G, B)
            drawer.clear(ColorRGBa(0.1, 0.1, 0.15))
            
            // 중앙에 원 그리기
            drawer.fill = ColorRGBa(0.9, 0.4, 0.3)
            drawer.circle(drawer.bounds.center, 150.0)
        }
    }
}

4. 실행

fun main() 옆의 초록색 재생 삼각 버튼(▶)을 클릭하고 Run 'MainKt'를 실행하면 템플릿 프로젝트 없이 최소 환경으로 창이 렌더링됩니다.