[NUI] PenWaveCanvas #6577

JoogabYun · 2025-01-14T06:56:32Z

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 · 2025-01-14T07:00:54Z

Internal API Changed

Added: 255, Removed: 0, Changed: 0

PenWave: Binds the drawing engine’s API. PenWaveCanvas: Provides a Canvas using a drawing engine, allowing users to easily use drawing functions. https://confluence.sec.samsung.net/display/GFX/PenWave+Sharp

TizenAPI-Bot · 2025-01-14T08:45:27Z

Internal API Changed

Added: 255, Removed: 0, Changed: 0

TizenAPI-Bot · 2025-01-15T04:24:09Z

Internal API Changed

Added: 257, Removed: 0, Changed: 0

TizenAPI-Bot · 2025-01-15T04:31:05Z

Internal API Changed

Added: 257, Removed: 0, Changed: 0

TizenAPI-Bot · 2025-01-15T06:43:55Z

Internal API Changed

Added: 257, Removed: 0, Changed: 0

TizenAPI-Bot · 2025-01-15T08:32:12Z

Public API Changed

Please follow the ACR process for the changed API below.

Added: 5, Removed: 0, Changed: 0

Added

+ /// <since_tizen>none</since_tizen
+ Tizen.NUI.PenWave.SelectionOperationType

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::Copy

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::Cut

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::None

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::Paste

Internal API Changed

Added: 259, Removed: 0, Changed: 0

TizenAPI-Bot · 2025-01-15T08:53:21Z

Public API Changed

Please follow the ACR process for the changed API below.

Added: 5, Removed: 0, Changed: 0

Added

+ /// <since_tizen>none</since_tizen
+ Tizen.NUI.PenWave.SelectionOperationType

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::Copy

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::Cut

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::None

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::Paste

Internal API Changed

Added: 260, Removed: 0, Changed: 0

TizenAPI-Bot · 2025-01-15T09:04:53Z

Public API Changed

Please follow the ACR process for the changed API below.

Added: 5, Removed: 0, Changed: 0

Added

+ /// <since_tizen>none</since_tizen
+ Tizen.NUI.PenWave.SelectionOperationType

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::Copy

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::Cut

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::None

+ /// <since_tizen>none</since_tizen
+ static Tizen.NUI.PenWave.SelectionOperationType Tizen.NUI.PenWave.SelectionOperationType::Paste

Internal API Changed

Added: 260, Removed: 0, Changed: 0

bshsqa

Is icon_user - Copy.svg different with icon_user.svg?

JoogabYun marked this pull request as ready for review January 14, 2025 06:56

github-actions bot added the Devel-NUI label Jan 14, 2025

JoogabYun mentioned this pull request Jan 14, 2025

[NUI] PenWave #6522

Closed

TizenAPI-Bot added the Internal API Changed label Jan 14, 2025

JoogabYun force-pushed the PenWave_0114 branch from 3d3e7e2 to e53842c Compare January 14, 2025 08:19

JoogabYun requested review from hyunjushin, dongsug-song, Seoyeon2Kim, taehyub, jaehyun0cho, everLEEst, rabbitfor and hinohie as code owners January 14, 2025 08:19

JoogabYun added 3 commits January 14, 2025 17:33

[NUI] PenWave

23f3975

PenWave: Binds the drawing engine’s API. PenWaveCanvas: Provides a Canvas using a drawing engine, allowing users to easily use drawing functions. https://confluence.sec.samsung.net/display/GFX/PenWave+Sharp

PenWave CodeClean

ba0fd63

[NUI] PenWave Coding rule

f824d51

JoogabYun force-pushed the PenWave_0114 branch from e53842c to 4c0bdb6 Compare January 14, 2025 08:37

JoogabYun force-pushed the PenWave_0114 branch from 4c0bdb6 to 2748d56 Compare January 15, 2025 04:19

JoogabYun force-pushed the PenWave_0114 branch from 2748d56 to c4239c8 Compare January 15, 2025 04:26

JoogabYun force-pushed the PenWave_0114 branch from c4239c8 to 20e4aea Compare January 15, 2025 06:39

JoogabYun force-pushed the PenWave_0114 branch from 20e4aea to 720973a Compare January 15, 2025 08:27

TizenAPI-Bot added the ACR Required label Jan 15, 2025

JoogabYun force-pushed the PenWave_0114 branch from 720973a to ae28f2b Compare January 15, 2025 08:48

[NUI] PenWave Code Clean

1bfb291

JoogabYun force-pushed the PenWave_0114 branch from ae28f2b to 1bfb291 Compare January 15, 2025 09:00

bshsqa reviewed Jan 16, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[NUI] PenWaveCanvas #6577

[NUI] PenWaveCanvas #6577

JoogabYun commented Jan 14, 2025

TizenAPI-Bot commented Jan 14, 2025

TizenAPI-Bot commented Jan 14, 2025

TizenAPI-Bot commented Jan 15, 2025

TizenAPI-Bot commented Jan 15, 2025

TizenAPI-Bot commented Jan 15, 2025

TizenAPI-Bot commented Jan 15, 2025

Added

TizenAPI-Bot commented Jan 15, 2025

Added

TizenAPI-Bot commented Jan 15, 2025

Added

bshsqa left a comment

[NUI] PenWaveCanvas #6577

Are you sure you want to change the base?

[NUI] PenWaveCanvas #6577

Conversation

JoogabYun commented Jan 14, 2025

Description of Change

API Changes

TizenAPI-Bot commented Jan 14, 2025

Internal API Changed

TizenAPI-Bot commented Jan 14, 2025

Internal API Changed

TizenAPI-Bot commented Jan 15, 2025

Internal API Changed

TizenAPI-Bot commented Jan 15, 2025

Internal API Changed

TizenAPI-Bot commented Jan 15, 2025

Internal API Changed

TizenAPI-Bot commented Jan 15, 2025

Public API Changed

Added

Internal API Changed

TizenAPI-Bot commented Jan 15, 2025

Public API Changed

Added

Internal API Changed

TizenAPI-Bot commented Jan 15, 2025

Public API Changed

Added

Internal API Changed

bshsqa left a comment

Choose a reason for hiding this comment