Branch data Line data Source code
1 : : /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 : : /*************************************************************************
3 : : *
4 : : * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5 : : *
6 : : * Copyright 2000, 2010 Oracle and/or its affiliates.
7 : : *
8 : : * OpenOffice.org - a multi-platform office productivity suite
9 : : *
10 : : * This file is part of OpenOffice.org.
11 : : *
12 : : * OpenOffice.org is free software: you can redistribute it and/or modify
13 : : * it under the terms of the GNU Lesser General Public License version 3
14 : : * only, as published by the Free Software Foundation.
15 : : *
16 : : * OpenOffice.org is distributed in the hope that it will be useful,
17 : : * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 : : * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 : : * GNU Lesser General Public License version 3 for more details
20 : : * (a copy is included in the LICENSE file that accompanied this code).
21 : : *
22 : : * You should have received a copy of the GNU Lesser General Public License
23 : : * version 3 along with OpenOffice.org. If not, see
24 : : * <http://www.openoffice.org/license.html>
25 : : * for a copy of the LGPLv3 License.
26 : : *
27 : : ************************************************************************/
28 : :
29 : : #ifndef _SVDHDL_HXX
30 : : #define _SVDHDL_HXX
31 : :
32 : : #include <tools/gen.hxx>
33 : :
34 : : #include <vcl/pointr.hxx>
35 : :
36 : : #include <svl/solar.hrc>
37 : :
38 : : #include <svx/xpoly.hxx>
39 : : #include <svx/svdoedge.hxx>
40 : : #include <svx/sdr/overlay/overlayobjectlist.hxx>
41 : : #include "svx/svxdllapi.h"
42 : :
43 : : class VirtualDevice;
44 : : class OutputDevice;
45 : : class Region;
46 : : class Window;
47 : : class SdrHdlList;
48 : : class SdrMarkView;
49 : : class SdrObject;
50 : : class SdrPageView;
51 : : class MouseEvent;
52 : :
53 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
54 : :
55 : : // Jedes Objekt muss in der Lage seine Handles zu erzeugen. Diese werden dann
56 : : // bei einer Selektion abgeholt, bei der View angemeldet und sichtbar gemacht.
57 : : // Wird ein Handle von der Maus beruehrt (IsHit()), so wird von der View der
58 : : // entsprechende Mauszeiger vom Handle abgeholt und der App auf Anfrage zum
59 : : // reinschalten uebergeben.
60 : : // Handles wie z.B. der Rotationsmittelpunkt oder die Spiegelachse werden von
61 : : // der View generiert, wenn vom Controller der entsprechende Transformations-
62 : : // Modus selektiert wird.
63 : : // HDL_MOVE...HDL_LWRGT muessen im enum immer zusammen stehen bleiben!
64 : :
65 : : enum SdrHdlKind
66 : : {
67 : : HDL_MOVE, // Handle zum Verschieben des Objekts
68 : : HDL_UPLFT, // Oben links
69 : : HDL_UPPER, // Oben
70 : : HDL_UPRGT, // Oben rechts
71 : : HDL_LEFT, // Links
72 : : HDL_RIGHT, // Rechts
73 : : HDL_LWLFT, // Unten links
74 : : HDL_LOWER, // Unten
75 : : HDL_LWRGT, // Unten rechts
76 : : HDL_POLY, // Punktselektion an Polygon oder Bezierkurve
77 : : HDL_BWGT, // Gewicht an einer Bezierkurve
78 : : HDL_CIRC, // Winkel an Kreissegmenten, Eckenradius am Rect
79 : : HDL_REF1, // Referenzpunkt 1, z.B. Rotationsmitte
80 : : HDL_REF2, // Referenzpunkt 2, z.B. Endpunkt der Spiegelachse
81 : : HDL_MIRX, // Die Spiegelachse selbst
82 : : HDL_GLUE, // GluePoint
83 : : HDL_GLUE_DESELECTED, // GluePoint
84 : : HDL_ANCHOR, // anchor symbol (SD, SW)
85 : : HDL_TRNS, // interactive transparence
86 : : HDL_GRAD, // interactive gradient
87 : : HDL_COLR, // interactive color
88 : : HDL_USER,
89 : : HDL_ANCHOR_TR, // #101688# Anchor handle with (0,0) at top right for SW
90 : :
91 : : // for SJ and the CustomShapeHandles:
92 : : HDL_CUSTOMSHAPE1,
93 : :
94 : : HDL_SMARTTAG
95 : : };
96 : :
97 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
98 : :
99 : : enum BitmapColorIndex
100 : : {
101 : : LightGreen,
102 : : Cyan,
103 : : LightCyan,
104 : : Red,
105 : : LightRed,
106 : : Yellow
107 : : };
108 : :
109 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
110 : :
111 : : enum BitmapMarkerKind
112 : : {
113 : : Rect_7x7,
114 : : Rect_9x9,
115 : : Rect_11x11,
116 : : Rect_13x13,
117 : : Circ_7x7,
118 : : Circ_9x9,
119 : : Circ_11x11,
120 : : Elli_7x9,
121 : : Elli_9x11,
122 : : Elli_9x7,
123 : : Elli_11x9,
124 : : RectPlus_7x7,
125 : : RectPlus_9x9,
126 : : RectPlus_11x11,
127 : : Crosshair,
128 : : Glue,
129 : : Glue_Deselected,
130 : : Anchor,
131 : :
132 : : // #98388# add AnchorPressed to be able to aninate anchor control, too.
133 : : AnchorPressed,
134 : :
135 : : // #101688# AnchorTR for SW
136 : : AnchorTR,
137 : : AnchorPressedTR,
138 : :
139 : : // for SJ and the CustomShapeHandles:
140 : : Customshape1
141 : : };
142 : :
143 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
144 : :
145 : : class SVX_DLLPUBLIC SdrHdl
146 : : {
147 : : friend class SdrMarkView; // fuer den Zugriff auf nObjHdlNum
148 : : friend class SdrHdlList;
149 : :
150 : : static BitmapEx ImpGetBitmapEx(BitmapMarkerKind eKindOfMarker, sal_uInt16 nInd);
151 : :
152 : : protected:
153 : : SdrObject* pObj; // Gehoert das Handle zu einem Objekt?
154 : : SdrPageView* pPV; // Gehoert das Handle zu einem Objekt in einer bestimmten PageView?
155 : : SdrHdlList* pHdlList; // Zum Feststelen der Handlegroesse
156 : :
157 : : // OVERLAYMANAGER
158 : : ::sdr::overlay::OverlayObjectList maOverlayGroup;
159 : :
160 : : Point aPos;
161 : :
162 : : SdrHdlKind eKind;
163 : :
164 : : long nDrehWink; // Handles bzw. Mauszeiger drehen
165 : : sal_uInt32 nObjHdlNum; // wird von der MarkView benoetigt
166 : : sal_uInt32 nPolyNum; // Polygonpunktes
167 : : sal_uInt32 nPPntNum; // Punktnummer des Polygons
168 : : sal_uInt32 nSourceHdlNum; // ist noch vollstaendig zu implementieren
169 : :
170 : : unsigned bSelect : 1; // Ein selektierter Polygonpunkt?
171 : : unsigned b1PixMore : 1; // True=Handle wird 1 Pixel groesser dargestellt
172 : : unsigned bPlusHdl : 1; // u.a. fuer Hld-Paint Optimierung bei MarkPoint/UnmarkPoint, ...
173 : :
174 : : bool mbMoveOutside; // forces this handle to be moved outside of the selection rectangle
175 : :
176 : : // create marker for this kind
177 : : virtual void CreateB2dIAObject();
178 : :
179 : : // cleanup marker if one exists
180 : : void GetRidOfIAObject();
181 : :
182 : : private:
183 : : bool mbMouseOver; // is true if the mouse is over this handle
184 : :
185 : : protected:
186 : : ::sdr::overlay::OverlayObject* CreateOverlayObject(
187 : : const basegfx::B2DPoint& rPos,
188 : : BitmapColorIndex eColIndex, BitmapMarkerKind eKindOfMarker, Point aMoveOutsideOffset = Point());
189 : : BitmapMarkerKind GetNextBigger(BitmapMarkerKind eKnd) const;
190 : :
191 : : public:
192 : : SdrHdl();
193 : : explicit SdrHdl(const Point& rPnt, SdrHdlKind eNewKind=HDL_MOVE);
194 : : virtual ~SdrHdl();
195 : :
196 : 0 : const ::sdr::overlay::OverlayObjectList& getOverlayObjectList() const { return maOverlayGroup; }
197 : :
198 : : void SetHdlList(SdrHdlList* pList);
199 : 0 : SdrHdlKind GetKind() const { return eKind; }
200 : : void Touch();
201 : :
202 : 0 : const Point& GetPos() const { return aPos; }
203 : : void SetPos(const Point& rPnt);
204 : :
205 : : SdrPageView* GetPageView() const { return pPV; }
206 : 0 : void SetPageView(SdrPageView* pNewPV) { pPV=pNewPV; }
207 : :
208 : 0 : SdrObject* GetObj() const { return pObj; }
209 : : void SetObj(SdrObject* pNewObj);
210 : :
211 : 0 : sal_Bool IsSelected() const { return bSelect; }
212 : : void SetSelected(sal_Bool bJa=sal_True);
213 : :
214 : : void Set1PixMore(sal_Bool bJa=sal_True);
215 : : void SetDrehWink(long n);
216 : :
217 [ # # ][ # # ]: 0 : sal_Bool IsCornerHdl() const { return eKind==HDL_UPLFT || eKind==HDL_UPRGT || eKind==HDL_LWLFT || eKind==HDL_LWRGT; }
[ # # ][ # # ]
218 [ # # ][ # # ]: 0 : sal_Bool IsVertexHdl() const { return eKind==HDL_UPPER || eKind==HDL_LOWER || eKind==HDL_LEFT || eKind==HDL_RIGHT; }
[ # # ][ # # ]
219 : :
220 : 0 : void SetObjHdlNum(sal_uInt32 nNum) { nObjHdlNum=nNum; }
221 : 0 : sal_uInt32 GetObjHdlNum() const { return nObjHdlNum; }
222 : :
223 : 0 : void SetPolyNum(sal_uInt32 nNum) { nPolyNum=nNum; }
224 : 0 : sal_uInt32 GetPolyNum() const { return nPolyNum; }
225 : :
226 : 0 : void SetPointNum(sal_uInt32 nNum) { nPPntNum=nNum; }
227 : 0 : sal_uInt32 GetPointNum() const { return nPPntNum; }
228 : :
229 : 0 : void SetPlusHdl(sal_Bool bOn) { bPlusHdl=bOn; }
230 : 0 : sal_Bool IsPlusHdl() const { return bPlusHdl; }
231 : :
232 : 0 : void SetSourceHdlNum(sal_uInt32 nNum) { nSourceHdlNum=nNum; }
233 : 0 : sal_uInt32 GetSourceHdlNum() const { return nSourceHdlNum; }
234 : :
235 : : virtual Pointer GetPointer() const;
236 : : bool IsHdlHit(const Point& rPnt) const;
237 : :
238 : : // #97016# II
239 : : virtual sal_Bool IsFocusHdl() const;
240 : :
241 : : void SetMoveOutside( bool bMoveOutside );
242 : :
243 : : /** is called when the mouse enters the area of this handle. If the handle changes his
244 : : visualisation during mouse over it must override this method and call Touch(). */
245 : : virtual void onMouseEnter(const MouseEvent& rMEvt);
246 : :
247 : : /** is called when the mouse leaves the area of this handle. If the handle changes his
248 : : visualisation during mouse over it must override this method and call Touch(). */
249 : : virtual void onMouseLeave();
250 : :
251 : : static BitmapEx createGluePointBitmap() { return ImpGetBitmapEx(Glue_Deselected, 0); }
252 : : };
253 : :
254 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
255 : :
256 : : #define SDR_HANDLE_COLOR_SIZE_NORMAL Size(13, 13)
257 : : #define SDR_HANDLE_COLOR_SIZE_SELECTED Size(17, 17)
258 : :
259 : : class SVX_DLLPUBLIC SdrHdlColor : public SdrHdl
260 : : {
261 : : private:
262 : : // size of colr markers
263 : : Size aMarkerSize;
264 : :
265 : : // color
266 : : Color aMarkerColor;
267 : :
268 : : // callback link when value changed
269 : : Link aColorChangeHdl;
270 : :
271 : : // use luminance values only
272 : : unsigned bUseLuminance : 1;
273 : :
274 : : // create marker for this kind
275 : : SVX_DLLPRIVATE virtual void CreateB2dIAObject();
276 : :
277 : : // help functions
278 : : SVX_DLLPRIVATE Bitmap CreateColorDropper(Color aCol);
279 : : SVX_DLLPRIVATE Color GetLuminance(const Color& rCol);
280 : : SVX_DLLPRIVATE void CallColorChangeLink();
281 : :
282 : : public:
283 : : explicit SdrHdlColor(const Point& rRef, Color aCol = Color(COL_BLACK), const Size& rSize = Size(11, 11), sal_Bool bLum = sal_False);
284 : : virtual ~SdrHdlColor();
285 : :
286 : : sal_Bool IsUseLuminance() const { return bUseLuminance; }
287 : :
288 : : Color GetColor() const { return aMarkerColor; }
289 : : void SetColor(Color aNew, sal_Bool bCallLink = sal_False);
290 : :
291 : : const Size& GetSize() const { return aMarkerSize; }
292 : : void SetSize(const Size& rNew);
293 : :
294 : : void SetColorChangeHdl(const Link& rLink) { aColorChangeHdl = rLink; }
295 : : const Link& GetColorChangeHdl() const { return aColorChangeHdl; }
296 : : };
297 : :
298 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
299 : :
300 : : class SdrHdlGradient : public SdrHdl
301 : : {
302 : : private:
303 : : // pointer to used color handles
304 : : SdrHdlColor* pColHdl1;
305 : : SdrHdlColor* pColHdl2;
306 : :
307 : : // 2nd position
308 : : Point a2ndPos;
309 : :
310 : : // is this a gradient or a transparence
311 : : unsigned bGradient : 1;
312 : :
313 : : // select which handle to move
314 : : unsigned bMoveSingleHandle : 1;
315 : : unsigned bMoveFirstHandle : 1;
316 : :
317 : : // create marker for this kind
318 : : virtual void CreateB2dIAObject();
319 : :
320 : : public:
321 : : SdrHdlGradient(const Point& rRef1, const Point& rRef2, sal_Bool bGrad = sal_True);
322 : : virtual ~SdrHdlGradient();
323 : :
324 : : sal_Bool IsGradient() const { return bGradient; }
325 : :
326 : : // set the associated color handles
327 : : void SetColorHandles(SdrHdlColor* pL1, SdrHdlColor* pL2) { pColHdl1 = pL1; pColHdl2 = pL2; }
328 : : SdrHdlColor* GetColorHdl1() const { return pColHdl1; }
329 : : SdrHdlColor* GetColorHdl2() const { return pColHdl2; }
330 : :
331 : : const Point& Get2ndPos() const { return a2ndPos; }
332 : : void Set2ndPos(const Point& rPnt);
333 : :
334 : : // the link called by the color handles
335 : : DECL_LINK(ColorChangeHdl, SdrHdl*);
336 : :
337 : : // transformation call, create gradient from this handle
338 : : void FromIAOToItem(SdrObject* pObj, sal_Bool bSetItemOnObject, sal_Bool bUndo);
339 : :
340 : : // selection flags for interaction
341 : : sal_Bool IsMoveSingleHandle() const { return bMoveSingleHandle; }
342 : : void SetMoveSingleHandle(sal_Bool bNew) { bMoveSingleHandle = bNew; }
343 : : sal_Bool IsMoveFirstHandle() const { return bMoveFirstHandle; }
344 : : void SetMoveFirstHandle(sal_Bool bNew) { bMoveFirstHandle = bNew; }
345 : : };
346 : :
347 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
348 : :
349 : : // Spiegelachse
350 : : class SdrHdlLine: public SdrHdl
351 : : {
352 : : // create marker for this kind
353 : : virtual void CreateB2dIAObject();
354 : :
355 : : protected:
356 : : SdrHdl* pHdl1;
357 : : SdrHdl* pHdl2;
358 : :
359 : : public:
360 : : SdrHdlLine(SdrHdl& rHdl1, SdrHdl& rHdl2, SdrHdlKind eNewKind=HDL_MIRX) { eKind=eNewKind; pHdl1=&rHdl1; pHdl2=&rHdl2; }
361 : : virtual ~SdrHdlLine();
362 : :
363 : : virtual Pointer GetPointer() const;
364 : : };
365 : :
366 : : // Ein SdrHdlBezWgt hat Kenntnis von seinem "BasisHandle". Seine Draw-Methode
367 : : // zeichnet zusaetzlich eine Linie von seiner Position zur Position dieses
368 : : // BasisHandles.
369 : : class SdrHdlBezWgt: public SdrHdl
370 : : {
371 : : // create marker for this kind
372 : : virtual void CreateB2dIAObject();
373 : :
374 : : protected:
375 : : const SdrHdl* pHdl1;
376 : :
377 : : public:
378 : : // das ist kein Copy-Ctor!!!
379 : : SdrHdlBezWgt(const SdrHdl* pRefHdl1, SdrHdlKind eNewKind=HDL_BWGT) { eKind=eNewKind; pHdl1=pRefHdl1; }
380 : : virtual ~SdrHdlBezWgt();
381 : : };
382 : :
383 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
384 : :
385 : : class E3dVolumeMarker : public SdrHdl
386 : : {
387 : : basegfx::B2DPolyPolygon aWireframePoly;
388 : :
389 : : // create marker for this kind
390 : : virtual void CreateB2dIAObject();
391 : :
392 : : public:
393 : : explicit E3dVolumeMarker(const basegfx::B2DPolyPolygon& rWireframePoly);
394 : : };
395 : :
396 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
397 : :
398 : : class ImpEdgeHdl: public SdrHdl
399 : : {
400 : : SdrEdgeLineCode eLineCode;
401 : :
402 : : // create marker for this kind
403 : : virtual void CreateB2dIAObject();
404 : :
405 : : public:
406 : : ImpEdgeHdl(const Point& rPnt, SdrHdlKind eNewKind): SdrHdl(rPnt,eNewKind),eLineCode(MIDDLELINE) {}
407 : : virtual ~ImpEdgeHdl();
408 : :
409 : : void SetLineCode(SdrEdgeLineCode eCode);
410 : : SdrEdgeLineCode GetLineCode() const { return eLineCode; }
411 : : sal_Bool IsHorzDrag() const;
412 : : virtual Pointer GetPointer() const;
413 : : };
414 : :
415 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
416 : :
417 : : class ImpMeasureHdl: public SdrHdl
418 : : {
419 : : // create marker for this kind
420 : : virtual void CreateB2dIAObject();
421 : :
422 : : public:
423 : : ImpMeasureHdl(const Point& rPnt, SdrHdlKind eNewKind): SdrHdl(rPnt,eNewKind) {}
424 : : virtual ~ImpMeasureHdl();
425 : :
426 : : virtual Pointer GetPointer() const;
427 : : };
428 : :
429 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
430 : :
431 : : class ImpTextframeHdl: public SdrHdl
432 : : {
433 : : const Rectangle maRect;
434 : :
435 : : // create marker for this kind
436 : : virtual void CreateB2dIAObject();
437 : :
438 : : public:
439 : : explicit ImpTextframeHdl(const Rectangle& rRect);
440 : : };
441 : :
442 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
443 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
444 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
445 : :
446 : : class SVX_DLLPUBLIC SdrHdlList
447 : : {
448 : : protected:
449 : : sal_uIntPtr mnFocusIndex;
450 : : SdrMarkView* pView;
451 : : std::deque<SdrHdl*> aList;
452 : : sal_uInt16 nHdlSize;
453 : :
454 : : unsigned bRotateShear : 1;
455 : : unsigned bDistortShear : 1;
456 : : unsigned bMoveOutside : 1; // Handles nach aussen ruecken (fuer TextEdit)
457 : :
458 : : private:
459 : : SVX_DLLPRIVATE SdrHdlList(const SdrHdlList&): aList() {}
460 : : SVX_DLLPRIVATE void operator=(const SdrHdlList&) {}
461 : : SVX_DLLPRIVATE sal_Bool operator==(const SdrHdlList&) const { return sal_False; }
462 : : SVX_DLLPRIVATE sal_Bool operator!=(const SdrHdlList&) const { return sal_False; }
463 : :
464 : : public:
465 : : explicit SdrHdlList(SdrMarkView* pV);
466 : : ~SdrHdlList();
467 : : void Clear();
468 : :
469 : : // #97016# II
470 : : void TravelFocusHdl(sal_Bool bForward);
471 : : SdrHdl* GetFocusHdl() const;
472 : : void SetFocusHdl(SdrHdl* pNew);
473 : : void ResetFocusHdl();
474 : :
475 : : // Access to View
476 : : SdrMarkView* GetView() const;
477 : :
478 : : // Sortierung: 1.Level Erst Refpunkt-Handles, dann normale Handles, dann Glue, dann User, dann Plushandles
479 : : // 2.Level PageView (Pointer)
480 : : // 3.Level Position (x+y)
481 : : void Sort();
482 : 0 : sal_uIntPtr GetHdlCount() const { return aList.size(); }
483 : 0 : SdrHdl* GetHdl(sal_uIntPtr nNum) const { return aList[nNum]; }
484 : : sal_uIntPtr GetHdlNum(const SdrHdl* pHdl) const;
485 : : void SetHdlSize(sal_uInt16 nSiz);
486 : : sal_uInt16 GetHdlSize() const { return nHdlSize; }
487 : : void SetMoveOutside(sal_Bool bOn);
488 : : sal_Bool IsMoveOutside() const { return bMoveOutside; }
489 : : void SetRotateShear(sal_Bool bOn);
490 : : sal_Bool IsRotateShear() const { return bRotateShear; }
491 : : void SetDistortShear(sal_Bool bOn);
492 : : sal_Bool IsDistortShear() const { return bDistortShear; }
493 : :
494 : : // AddHdl uebernimmt das Handle in sein Eigentum. Es muss
495 : : // also auf dem Heap stehen, da Clear() ein delete macht.
496 : : void AddHdl(SdrHdl* pHdl, sal_Bool bAtBegin=sal_False);
497 : : SdrHdl* RemoveHdl(sal_uIntPtr nNum);
498 : : void RemoveAllByKind(SdrHdlKind eKind);
499 : :
500 : : // Zuletzt eingefuegte Handles werden am ehesten getroffen
501 : : // (wenn Handles uebereinander liegen).
502 : : SdrHdl* IsHdlListHit(const Point& rPnt, sal_Bool bBack=sal_False, sal_Bool bNext=sal_False, SdrHdl* pHdl0=NULL) const;
503 : : SdrHdl* GetHdl(SdrHdlKind eKind1) const;
504 : : };
505 : :
506 : : ////////////////////////////////////////////////////////////////////////////////////////////////////
507 : :
508 : : class SVX_DLLPUBLIC SdrCropHdl : public SdrHdl
509 : : {
510 : : public:
511 : : SdrCropHdl(const Point& rPnt, SdrHdlKind eNewKind);
512 : :
513 : : protected:
514 : : // create marker for this kind
515 : : virtual void CreateB2dIAObject();
516 : :
517 : : BitmapEx GetBitmapForHandle( const BitmapEx& rBitmap, int nSize );
518 : :
519 : : static BitmapEx GetHandlesBitmap();
520 : : };
521 : :
522 : : #endif //_SVDHDL_HXX
523 : :
524 : : /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|