@compass-framework/core 1.2.56 → 1.2.57

package/@types/Paint.d.ts

@@ -1,137 +1,202 @@
-import { CharSequence, TextString } from "@compass-framework/library";
-import { Rect } from "./Rect";
-import { Shadow } from "./Shadow";
+import { CharSequence, InterfaceTemplate } from "@compass-framework/library";
 import { Shader } from "./Shader";
+import { Shadow } from "./Shadow";
+import { Rect } from "./Rect";
 import { Typeface } from "./Typeface";
 import { PathEffect } from "./PathEffect";
+import { Context } from "./Context";
+import { ColorFilter } from "./ColorFilter";
+import { BlendMode } from "./BlendMode";
+import { ImageFilter } from "./ImageFilter";
+
+/**
+ * 画笔，描述颜色、样式、字体等绘制属性。
+ */
+export interface Paint {
+  measureText(text: CharSequence): number;
+  measureText(text: CharSequence, start: number, end: number): number;
+
+  set(paint: Paint): Paint
+
+  adjustForPixelPerfectLine(pixel: number): void;
+
+  isAntiAlias(): boolean;
+
+  isTextSkewX(): boolean;
 
-export declare class Paint {
-  public static UNDERLINE_TEXT_FLAG: number;
-  public static STRIKE_THRU_TEXT_FLAG: number;
+  getPixelPerfectLine(): number
 
-  public constructor();
-  public constructor(paint: Paint);
+  getFontMetrics(): Paint.FontMetrics
+  getFontMetrics(fontMetrics: Paint.FontMetrics): number
 
-  public adjustForPixelPerfectLine(pixel: number): void;
+  getTextWidths(text: CharSequence, widths: number[]): number
+  getTextWidths(text: CharSequence, start: number, end: number, widths: number[]): number
+  getTextWidths(text: string[], index:number, count:number, widths: number[]): number
 
-  public pointsToPixel(points: number): number;
+  getTextBounds(text: CharSequence, bounds: Rect): void
+  getTextBounds(text: CharSequence, start: number, end: number, bounds: Rect): void
 
-  public measureText(text: CharSequence): number;
-  public measureText(text: CharSequence, start: number, end: number): number;
+  breakText(text: CharSequence, measureForwards: boolean, maxWidth: number, measuredWidth: number[]): number
+  breakText(text: CharSequence, start: number, end: number, measureForwards: boolean, maxWidth: number, measuredWidth: number[]): number
 
-  public breakText(text: CharSequence, measureForwards: boolean, maxWidth: number, measuredWidth: number[]): number;
-  public breakText(text: CharSequence, start: number, end: number, measureForwards: boolean, maxWidth: number, measuredWidth: number[]): number;
+  getStyle(): Paint.Style;
 
-  public set(paint: Paint): Paint;
+  copy(): Paint;
 
-  public getPixelPerfectLine(): number;
+  getImageFilter(): ImageFilter;
 
-  public getTextWidths(text: TextString, widths: number[]): number;
-  public getTextWidths(text: TextString, start: number, end: number, widths: number[]): number;
-  public getTextWidths(text: CharSequence, start: number, end: number, widths: number[]): number;
+  getFlags(): number
 
-  public getTextBounds(text: CharSequence, bounds: Rect): void;
-  public getTextBounds(text: CharSequence, start: number, end: number, bounds: Rect): void;
+  getAlpha(): number
 
-  public getFontMetrics(): Paint.FontMetrics;
-  public getFontMetrics(fontMetrics: Paint.FontMetrics): number;
+  getColor(): number
 
-  public getTextFontMetrics(text: CharSequence): Paint.FontMetrics;
-  public getTextFontMetrics(text: CharSequence, fontMetrics: Paint.FontMetrics): number;
+  getColorString(): string
 
-  public getStyle(): Paint.Style;
+  getStrokeJoin(): Paint.Join
 
-  public getFlags(): number;
+  getStrokeCap(): Paint.Cap
 
-  public getColor(): number;
+  getShadow(): Shadow
 
-  public getAlpha(): number;
+  getTextSize(): number
 
-  public getTextAlign(): Paint.Align;
+  getColorFilter(): ColorFilter;
 
-  public getStrokeJoin(): Paint.Join;
+  getTextAlign(): Paint.Align
 
-  public getStrokeCap(): Paint.Cap;
+  getShader(): Shader;
 
-  public getShadow(): Shadow;
+  getStrokeWidth(): number
 
-  public getTextSize(): number;
+  getTextSkewX(): number;
 
-  public getFontSpacing(): number;
+  getFakeBoldText(): boolean;
 
-  public getShader(): Shader;
+  getBlendMode(): BlendMode;
 
-  public getStrokeWidth(): number;
+  getTypeface(): Typeface;
 
-  public getTypeface(): Typeface;
+  getPathEffect(): PathEffect
 
-  public getTextSkewX(): number;
+  getTextScaleX(): number;
 
-  public getFakeBoldText(): boolean;
+  setStrokeWidth(width: number): void
 
-  public setPathEffect(pathEffect: PathEffect): void;
+  setPathEffect(pathEffect: PathEffect): void
 
-  public setFakeBoldText(bold: boolean): void;
+  setAntiAlias(aa: boolean): void;
 
-  public setAlpha(a: number): void;
+  setColor(color: number): void
 
-  public setTextSkewX(value: number): void;
+  setStrokeJoin(join: Paint.Join): void
 
-  public setShadow(shadow: Shadow): void;
+  setTextSize(textSize: number): void
 
-  public setShader(shader: Shader): void;
+  setStrokeCap(cap: Paint.Cap): void
 
-  public setFlags(flags: number): void;
+  getFontSpacing(): number;
 
-  public setStrokeWidth(width: number): void;
+  setTextAlign(textAlign: Paint.Align): void
 
-  public setColor(color: number): void;
+  setFlags(flags: number): void
 
-  public setStyle(style: Paint.Style): void;
+  setImageFilter(imageFilter: ImageFilter): void;
 
-  public setStrokeCap(cap: Paint.Cap): void;
+  setStyle(style: Paint.Style): void
 
-  public setStrokeJoin(join: Paint.Join): void;
+  setAlpha(a: number): void
 
-  public setTextSize(textSize: number): void;
+  setShadow(shadow: Shadow): void
 
-  public setTypeface(typeface: Typeface): void;
+  setShader(shader: Shader): void
 
-  public setTextAlign(textAlign: Paint.Align): void;
+  setColorFilter(filter: ColorFilter): void;
 
-  public setARGB(a: number, r: number, g: number, b: number): void;
+  setARGB(a: number, r: number, g: number, b: number): void
+
+  setTypeface(typeface: Typeface): void;
+
+  setTextScaleX(scaleX: number): void;
+
+  setTextSkewX(value: number): void;
+
+  setFakeBoldText(value: boolean): void;
+
+  setBlendMode(mode: BlendMode): void;
+
+  setStrikeThruText(value: boolean): void;
+
+  dispose(): void;
+
+  toString(): CharSequence;
 }
 
-export declare namespace Paint {
-  enum Join {
-    MITER,
-    ROUND,
-    BEVEL,
+/**
+ * Paint 接口的实现基类。
+ */
+export abstract class Paint extends InterfaceTemplate {}
+
+/**
+ * Paint 相关类型与工厂方法。
+ */
+export namespace Paint {
+  export const UNDERLINE_TEXT_FLAG: number;
+  export const STRIKE_THRU_TEXT_FLAG: number;
+
+  /**
+   * 字体度量信息。
+   */
+  export class FontMetrics {
+    public ascent: number;
+    public descent: number;
+    public top: number;
+    public bottom: number;
+    public leading: number;
+    public left: number;
+    public right: number;
+
+    public set(metrics: FontMetrics): FontMetrics;
   }
 
-  enum Cap {
-    BUTT,
-    ROUND,
-    SQUARE,
+  /**
+   * 描边转角连接样式。
+   */
+  export enum Join {
+    BEVEL = "bevel",
+    MITER = "miter",
+    ROUND = "round",
   }
 
-  enum Align {
-    LEFT = 'left',
-    CENTER = 'center',
-    RIGHT = 'right',
+  /**
+   * 描边端点样式。
+   */
+  export enum Cap {
+    BUTT = "butt",
+    ROUND = "round",
+    SQUARE = "square",
   }
 
-  enum Style {
+  /**
+   * 填充与描边绘制样式。
+   */
+  export enum Style {
     FILL,
     STROKE,
     FILL_AND_STROKE,
   }
 
-  class FontMetrics {
-    public ascent: number;
-    public descent: number;
-    public top: number;
-    public bottom: number;
-    public leading: number;
+  /**
+   * 文本水平对齐方式。
+   */
+  export enum Align {
+    LEFT = 'left',
+    CENTER = 'center',
+    RIGHT = 'right',
   }
+
+  /**
+   * 创建 Paint 实例。
+   */
+  export function create(context: Context): Paint;
 }

package/@types/Path.d.ts

@@ -1,77 +1,119 @@
+import { InterfaceTemplate } from "@compass-framework/library";
 import { Rect } from "./Rect";
 import { Matrix } from "./Matrix";
+import { PathEffect } from "./PathEffect";
+import { Context } from "./Context";
 
-export declare class Path {
-  public constructor();
-  public constructor(path: Path);
+/**
+ * 矢量路径，用于描述可绘制的几何轮廓。
+ */
+export interface Path {
+  setFillType(ft: Path.FillType): void
 
-  public arcTo(oval:Rect, startAngle: number, sweepAngle: number): void;
-  public arcTo(oval: Rect, startAngle: number, sweepAngle: number, forceMoveTo: boolean): void;
+  getFillType(): Path.FillType
 
-  public addRect(rect: Rect, dir: Path.Direction): void;
-  public addRect(left: number, top: number, right: number, bottom: number, dir: Path.Direction): void;
+  isInverseFillType(): boolean
 
-  public addOval(oval: Rect, dir: Path.Direction): void;
+  toggleInverseFillType(): void
 
-  public addCircle(x: number, y: number, radius: number, dir: Path.Direction): void;
+  arcTo(oval:Rect, startAngle: number, sweepAngle: number): void;
+  arcTo(oval: Rect, startAngle: number, sweepAngle: number, forceMoveTo: boolean): void;
 
-  public addArc(oval:Rect, startAngle: number, sweepAngle: number): void;
-  public addArc(left:number, top:number, right:number, bottom:number, startAngle: number, sweepAngle: number): void;
+  addRect(rect: Rect, dir: Path.Direction): void;
+  addRect(left: number, top: number, right: number, bottom: number, dir: Path.Direction): void;
 
-  public addPath(src: Path): void;
-  public addPath(src: Path, matrix: Matrix): void;
-  public addPath(src: Path, dx: number, dy: number): void;
+  addOval(oval: Rect, dir: Path.Direction): void
+  addOval(left: number, top: number, right: number, bottom: number, dir: Path.Direction): void
 
-  public addRoundRect(rect: Rect, radii: number[], dir: Path.Direction): void;
-  public addRoundRect(rect: Rect, rx: number, ry: number, dir: Path.Direction): void;
+  addCircle(x: number, y: number, radius: number, dir: Path.Direction): void
 
-  public offset(dx: number, dy: number): void;
-  public offset(dx: number, dy: number, dst: Path): void;
+  addPath(src: Path): void;
+  addPath(src: Path, matrix: Matrix): void;
+  addPath(src: Path, dx: number, dy: number): void;
 
-  public setLastPoint(dx: number, dy: number): void;
+  addArc(oval:Rect, startAngle: number, sweepAngle: number): void;
+  addArc(left:number, top:number, right:number, bottom:number, startAngle: number, sweepAngle: number): void;
 
-  public transform(matrix: Matrix): void;
-  public transform(matrix: Matrix, dst: Path): void;
+  addRoundRect(rect: Rect, radii: number[], dir: Path.Direction): void;
+  addRoundRect(rect: Rect, rx: number, ry: number, dir: Path.Direction): void;
 
-  public quadTo(x1: number, y1: number, x2: number, y2: number): void;
+  offset(dx: number, dy: number): void;
+  offset(dx: number, dy: number, dst: Path): void;
 
-  public rQuadTo(dx1: number, dy1: number, dx2: number, dy2: number): void;
+  setLastPoint(dx: number, dy: number): void
 
-  public reWind(): void;
+  transform(matrix: Matrix): void;
+  transform(matrix: Matrix, dst: Path): void;
 
-  public reset(): void;
+  quadTo(x1: number, y1: number, x2: number, y2: number): void
 
-  public set(src: Path): void;
+  rQuadTo(dx1: number, dy1: number, dx2: number, dy2: number): void
 
-  public isEmpty(): boolean;
+  reWind(): void
 
-  public isRect(rect: Rect): boolean;
+  reset(): void
 
-  public close(): void;
+  round(): void
 
-  public moveTo(x: number, y: number): void;
+  set(src: Path): void
 
-  public rMoveTo(dx: number, dy: number): void;
+  isEmpty(): boolean
 
-  public lineTo(x: number, y: number): void;
+  isRect(rect: Rect): boolean
 
-  public rLineTo(dx: number, dy: number): void;
+  isConvex(): boolean
 
-  public cubicTo(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number): void;
+  close():void
 
-  public rCubicTo(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number): void;
+  computeBounds(bounds: Rect, exact: boolean): void
+
+  moveTo(x: number, y: number): void
+
+  rMoveTo(dx: number, dy: number): void
+
+  lineTo(x: number, y: number): void
+
+  rLineTo(dx: number, dy: number): void
+
+  cubicTo(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number): void
+
+  rCubicTo(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number): void
+
+  setPathEffect(pathEffect: PathEffect, strokeWidth: number): void
+
+  dispose(): void;
 }
 
-export declare namespace Path {
-  enum Direction {
-    CW = 0,
-    CCW = 1,
+/**
+ * Path 接口的实现基类。
+ */
+export abstract class Path extends InterfaceTemplate {}
+
+/**
+ * Path 相关类型与工厂方法。
+ */
+export namespace Path {
+  /**
+   * 路径绕向（顺时针/逆时针）。
+   */
+  export enum Direction {
+    CW,
+    CCW,
   }
 
-  enum FillType {
-    WINDING = 0,
-    EVEN_ODD = 1,
-    INVERSE_WINDING = 2,
-    INVERSE_EVEN_ODD = 3,
+  /**
+   * 路径填充规则。
+   */
+  export enum FillType {
+    WINDING,
+    EVEN_ODD,
+    INVERSE_WINDING,
+    INVERSE_EVEN_ODD,
   }
+
+  /**
+   * 创建 Path 实例。
+   */
+  export function create(context: Context): Path;
+  export function create(context: Context, path: Path): Path;
 }

package/@types/PathEffect.ts

@@ -1,7 +1,13 @@
 import { InterfaceTemplate } from "@compass-framework/library";
 
+/**
+ * 路径效果，用于修改描边或轮廓的外观。
+ */
 export declare interface PathEffect {
-
+  dispose(): void;
 }
 
+/**
+ * PathEffect 接口的实现基类。
+ */
 export class PathEffect extends InterfaceTemplate {}

package/@types/Picture.d.ts

@@ -1,32 +1,41 @@
-import { Consumer, InterfaceTemplate } from "@compass-framework/library";
-import { Bitmap } from "./Bitmap";
+import { Consumer } from "@compass-framework/library";
+import { Image } from "./Image";
+import { Context } from "./Context";
 
-export declare interface Picture {
-  complete(): boolean;
+/**
+ * 图片资源，异步加载并提供位图图像。
+ */
+export declare class Picture {
+  public constructor(context: Context, url?: string);
 
-  oneListener(notify: Consumer<Picture.PictureStatus>): void
+  public complete(): boolean;
 
-  getUrl(): string;
+  public oneListener(notify: Consumer<Picture.PictureStatus>): void;
 
-  getWidth(): number
+  public addListener(notify: Consumer<Picture.PictureStatus>): void;
 
-  getHeight(): number
+  public removeListener(notify: Consumer<Picture.PictureStatus>): void;
 
-  addListener(notify: Consumer<Picture.PictureStatus>): void
+  public dispose(): void;
 
-  removeListener(notify: Consumer<Picture.PictureStatus>): void
+  public getWidth(): number;
 
-  setUrl(url: string): void
+  public getUrl(): string;
 
-  asBitmap(): Bitmap
-  asBitmap(scale: number): Bitmap
-}
+  public getHeight(): number;
 
-export class Picture extends InterfaceTemplate {
+  public getImage(): Image;
 
+  public setUrl(url: string): void;
 }
 
+/**
+ * Picture 相关状态类型。
+ */
 export declare namespace Picture {
+  /**
+   * 图片加载完成状态。
+   */
   enum PictureStatus {
     OK,
     FAIL,

package/@types/PictureDrawable.d.ts

@@ -1,12 +1,16 @@
 import { Consumer, Implements } from "@compass-framework/library";
 import { Paint } from "./Paint";
-import { BitmapDrawable } from "./BitmapDrawable";
+import { ImageDrawable } from "./ImageDrawable";
 import { Picture } from "./Picture";
 import { ImageView } from "./ImageView";
+import { Context } from "./Context";
 
+/**
+ * 基于 Picture 的图像 Drawable，支持加载状态通知。
+ */
 @Implements(ImageView.UpdateNotification)
-export declare class PictureDrawable extends BitmapDrawable implements ImageView.UpdateNotification<Picture.PictureStatus> {
-  public constructor(url?: string);
+export declare class PictureDrawable extends ImageDrawable implements ImageView.UpdateNotification<Picture.PictureStatus> {
+  public constructor(context: Context, url: string);
 
   public addNotification(c: Consumer<Picture.PictureStatus>): void;
 
@@ -14,8 +18,6 @@ export declare class PictureDrawable extends BitmapDrawable implements ImageView
 
   public removeNotification(c: Consumer<Picture.PictureStatus>): void;
 
-  public setUrl(url: string): void;
-
   public invalidate() : void;
 
   public getUrl(): string;

package/@types/PixelFormat.ts

@@ -1,3 +1,6 @@
+/**
+ * 像素格式常量，描述不透明、半透明等透明度类别。
+ */
 export declare class PixelFormat {
   public static UNKNOWN: number;
   public static OPAQUE: number;

package/@types/PopupWindow.d.ts

@@ -1,14 +1,17 @@
 import { ArrayList, Implements, XML } from "@compass-framework/library";
 import { Resources } from "./Resources";
-import { IWindow } from "./IWindow";
 import { View } from "./View";
-import { WindowContext } from "./WindowContext";
 import { ViewGroup } from "./ViewGroup";
 import { WindowManager } from "./WindowManager";
+import { Window } from "./Window";
 import { Configuration } from "./Configuration";
+import { Context } from "./Context";
 
-@Implements(IWindow)
-export declare class PopupWindow implements IWindow {
+/**
+ * 弹出窗口，在指定位置展示浮动内容视图。
+ */
+@Implements(Window)
+export declare class PopupWindow implements Window {
   public constructor();
 
   public findViewById(id: number): View;
@@ -18,7 +21,7 @@ export declare class PopupWindow implements IWindow {
 
   public findViewsByTag(tag: string): ArrayList<View>;
 
-  public onAttach(context: WindowContext): void;
+  public onAttach(context: Context): void;
 
   public onCreate(): void;
 
@@ -48,7 +51,7 @@ export declare class PopupWindow implements IWindow {
 
   public getOnTouchListener(): View.OnTouchListener;
 
-  public getWindowContext(): WindowContext;
+  public getContext(): Context;
 
   public getResources(): Resources;
 

package/@types/PropertyValuesHolder.d.ts

@@ -1,3 +1,6 @@
+/**
+ * 属性值持有者，保存动画属性及其关键序列。
+ */
 export declare class PropertyValuesHolder {
 
 }