[NUI] PenWaveCanvas

[JoogabYun]

Description of Change

https://confluence.sec.samsung.net/display/GFX/PenWave+Sharp

API Changes

• ACR:

PenWaveSharp의 목적

• 첫번째 목적은 HandDrawingEngne(PenWave)의 기능을 바인딩 하여 앱 개발자가 PenWave기능을 사용할 수 있게 하는 것 입니다.
  • 이를 위해 모든 PenWave의 기능을 바인딩하여 제공합니다.
• 두번째 목적은 PenWave의 기능을 좀 더 쉽게 사용할 수 있게 기능을 제공하는 것 입니다.
  • PenWaveCanvas를 생성만 해도 기본적인 기능을 디폴트로 제공하는 것 입니다.
  • 다양한 tool들에 대해 이미 구현되어 있고 이를 사용자가 그대로 사용할 수 있습니다.
  • 기본적인 UI를 제공하여 사용자가 해당 UI를 이용해 동작을 할 수 있습니다.
  • 여기선 PenWaveToolPicker를 제공하고 있습니다.

PenWaveCanvas의 개요

• 두번째 목적인 PenWave엔진의 기능을 좀 더 쉽게 사용하기 위해 PenWaveCanvas를 제공합니다.
• PenWaveCanvas는Tizen.NUI 기반의 드로잉 Component입니다. PenWaveCanvas는 사용자가 다양한 도구를 사용해 드로잉, 지우기, 선택, 캔버스 조작 등을 할 수 있도록 설계되었습니다.

PenWaveCanvas의 주요 구성 요소

• PenWaveCanvas
  • 핵심 컴포넌트로 드로잉 캔버스를 관리합니다.
  • 주요역할
    • 캔버스 초기화
    • 캔버스 렌더링(CanvasRenderer와 연결, CanvasRenderer는 실제 PenWave의 엔진과 연결되어 동작에 대해 관여하고 PenWaveCanvas는 화면 구성에만 관여합니다.)
    • 도구 설정 및 동작 처리
    • 캔버스 조작 (clear, undo/redo, backgroundColor, grid, screenshot, save/load 등)
  • ToolBase 및 하위 클래스
    • PenWave에서 사용할 수 있는 다양한 도구는 ToolBase를 기반으로 구현됩니다.
    • 공통 구조 (ToolBase)
      • 모든 Tool은 Activate(), Deactivate(), HandleInput() 메서드를 통해 동작합니다.
      • 작업 시작/완료 이벤트를 지원합니다.
    • 도구 종류
      • PencilTool
        • 펜 도구로 브러쉬 타입, 색상, 크기 설정 가능
        • 다양한 브러쉬 타입을 지원 (예 : Stroke, Highlighter, SoftBrush 등)
      • EraserTool
        • 지우개 도구로 크기와 지우는 방식 (partial, full)선택 가능
      • SelectionTool
        • 선택 도구로 객체를 선택하여 이동, 확대, 회전, 복사, 잘라내기, 붙여넣기 동작 가능
      • RulerTool
        • 자, 각도기 도구로 사각형, 원 그리기, 직선자, 각도기의 동작을 수행합니다.
  • PenWaveToolPicker
    • PenWave의 UI구성 요소로 사용자가 도구를 직관적으로 선택하고 설정할 수 있도록 기본 UI를 지원합니다.
    • 주요역할
      • 현재 캔버스와 연결하여 도구를 관리합니다.
      • 각 tool 및 캔버스 동작 등을 UI를 통해 사용자에게 제공합니다.
    • 주요 기능
      • 도구를 선택하고 설정 변경을 반영합니다.
  • UnRedoManager
    • PenWaveToolPicker에서 Undo/Redo 여부를 알 수 있도록 스택을 관리합니다.

PenWaveCanvas 주요 동작 흐름

• 캔버스 초기화
  • PenWaveCanvas 생성시 CanvasRenderer와 연결합니다.
  • 사용되는 도구를 연결합니다.
• 사용자가 도구를 선택
  • PenWaveToolPicker를 통해 도구를 선택할 수 있습니다. 이 경우 도구의 속성을 UI에서 설정 가능합니다. (브러쉬 타입, 색상, 크기 등)
  • 직접 Tool을 생성하여 PenWaveCanvas에 설정할 수 있습니다.
• 사용자 입력 처리
  • 사용자의 터치 입력은 HandleInput()을 통해 전달합니다.
  • 현재 활성화된 도구가 입력을 받아 처리합니다. (예 : 펜 드로잉, 지우기 등)

[TizenAPI-Bot]

Internal API Changed

Added: 255, Removed: 0, Changed: 0

[TizenAPI-Bot]

Internal API Changed

Added: 255, Removed: 0, Changed: 0

[TizenAPI-Bot]

Internal API Changed

Added: 257, Removed: 0, Changed: 0