kwin-styles/openlook/OpenLook.cpp

   1 /*
   2   'OpenLook' kwin client
   3
   4   Porting to kde3.2 API
   5     Copyright 2003 Luciano Montanaro <mikelima@cirulla.net>
   6
   7   Permission is hereby granted, free of charge, to any person obtaining a copy
   8   of this software and associated documentation files (the "Software"), to
   9   deal in the Software without restriction, including without limitation the
  10   rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
  11   sell copies of the Software, and to permit persons to whom the Software is
  12   furnished to do so, subject to the following conditions:
  13
  14   The above copyright notice and this permission notice shall be included in
  15   all copies or substantial portions of the Software.
  16
  17   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
  20   AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  21   ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  22   WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  23 */
  24
  25 #include "config.h"
  26 #include <unistd.h> // for usleep
  27 #include <math.h>
  28
  29 #include <qlayout.h>
  30 #include <qpainter.h>
  31 #include <qdrawutil.h>
  32 #include <qtoolbutton.h>
  33 #include <qimage.h>
  34 #include <qlabel.h>
  35 #include <qpixmap.h>
  36 //Added by qt3to4:
  37 #include <QPaintEvent>
  38 #include <Q3PointArray>
  39 #include <QEvent>
  40 #include <QBoxLayout>
  41 #include <Q3ValueList>
  42 #include <QShowEvent>
  43 #include <QVBoxLayout>
  44 #include <QResizeEvent>
  45 #include <QMouseEvent>
  46
  47 #include <kapplication.h>
  48 #include <klocale.h>
  49
  50 #include "OpenLook.h"
  51
  52 extern "C" KDE_EXPORT KDecorationFactory* create_factory()
  53 {
  54     return new OpenLook::DecorationFactory();
  55 }
  56
  57 namespace OpenLook {
  58
  59 static uint openLookCornerSize = 11;
  60 static uint openLookMargin = 5;
  61 static const uint openLookTextVMargin = 1;
  62 static uint titleHeight;
  63
  64 // ---------------------------------------
  65
  66 DecorationFactory::DecorationFactory()
  67 {
  68 }
  69
  70 DecorationFactory::~DecorationFactory()
  71 {
  72 }
  73
  74 KDecoration *DecorationFactory::createDecoration(KDecorationBridge *b)
  75 {
  76     return new OpenLook(b, this);
  77 }
  78
  79 bool DecorationFactory::reset(unsigned long /*changed*/)
  80 {
  81     // TODO Do not recreate decorations if it is not needed. Look at
  82     // ModernSystem for how to do that
  83     // For now just return true.
  84     return true;
  85 }
  86
  87 bool DecorationFactory::supports( Ability ability )
  88 {
  89     switch( ability )
  90     {
  91         case AbilityAnnounceButtons:
  92         case AbilityButtonMinimize:
  93             return true;
  94         default:
  95             return false;
  96     };
  97 }
  98
  99 QList< DecorationFactory::BorderSize > DecorationFactory::borderSizes() const
 100 {
 101     // the list must be sorted
 102     return QList< BorderSize >() << BorderNormal <<
 103         BorderLarge << BorderVeryLarge <<  BorderHuge <<
 104         BorderVeryHuge << BorderOversized;
 105 }
 106
 107 // ---------------------------------------
 108
 109 static inline const KDecorationOptions* options()
 110 {
 111     return KDecoration::options();
 112 }
 113
 114 // ---------------------------------------
 115
 116 OpenLook::OpenLook(KDecorationBridge *b, KDecorationFactory *f) :
 117     KDecoration(b, f),
 118     titleSpacer_    (0),
 119     mousePressPoint_(0, 0), // Anywhere outside button rect.
 120     buttonDown_     (false)
 121 {
 122 }
 123
 124 void OpenLook::init()
 125 {
 126   static const int SUPPORTED_WINDOW_TYPES_MASK = NET::NormalMask |
 127     NET::DesktopMask | NET::DockMask | NET::ToolbarMask | NET::MenuMask |
 128     NET::DialogMask | NET::OverrideMask | NET::TopMenuMask |
 129     NET::UtilityMask | NET::SplashMask;
 130
 131   createMainWidget( Qt::WResizeNoErase);
 132   widget()->setAttribute( Qt::WA_StaticContents);
 133   widget()->setAttribute( Qt::WA_NoBackground );
 134   widget()->installEventFilter(this);
 135   widget()->setBackgroundMode(NoBackground);
 136   NET::WindowType type = windowType(SUPPORTED_WINDOW_TYPES_MASK);
 137   tool_ = (type == NET::Toolbar || type == NET::Utility || type == NET::Menu);
 138   QFontMetrics fm(options()->font(isActive(), tool_));
 139
 140   titleHeight = fm.height() + openLookTextVMargin * 2;
 141
 142   switch(KDecoration::options()->preferredBorderSize(factory())) {
 143       case KDecoration::BorderLarge:
 144           openLookMargin = 9;
 145           break;
 146       case KDecoration::BorderVeryLarge:
 147           openLookMargin = 13;
 148           break;
 149       case KDecoration::BorderHuge:
 150           openLookMargin = 18;
 151           break;
 152       case KDecoration::BorderVeryHuge:
 153           openLookMargin = 27;
 154           break;
 155       case KDecoration::BorderOversized:
 156           openLookMargin = 40;
 157           break;
 158       case KDecoration::BorderNormal:
 159       default:
 160           openLookMargin = 5;
 161   }
 162   openLookCornerSize = 2*openLookMargin + 1;
 163   if (titleHeight <= openLookMargin)
 164       titleHeight = openLookMargin+1;
 165
 166   doLayout();
 167 }
 168
 169 OpenLook::~OpenLook()
 170 {
 171   // Empty.
 172 }
 173
 174 bool OpenLook::eventFilter(QObject *o, QEvent *e)
 175 {
 176   if (o != widget()) return false;
 177   switch (e->type()) {
 178   case QEvent::Resize:
 179     resizeEvent(static_cast< QResizeEvent* >(e));
 180     return true;
 181   case QEvent::Paint:
 182     paintEvent(static_cast< QPaintEvent* >(e));
 183     return true;
 184   case QEvent::MouseButtonDblClick:
 185     mouseDoubleClickEvent(static_cast< QMouseEvent* >(e));
 186     return true;
 187   case QEvent::MouseButtonPress:
 188     if (!isButtonPress(static_cast< QMouseEvent* >(e))) {
 189       processMousePressEvent(static_cast< QMouseEvent* >(e));
 190     }
 191     return true;
 192   case QEvent::MouseButtonRelease:
 193     if (isButtonRelease(static_cast< QMouseEvent* >(e))) {
 194       return true;
 195     } else {
 196       return false;
 197     }
 198   case QEvent::Show:
 199     showEvent(static_cast< QShowEvent* >(e));
 200     return true;
 201   default:
 202     break;
 203   }
 204   return false;
 205 }
 206
 207   void
 208 OpenLook::borders(int &left, int &right, int &top, int &bottom) const
 209 {
 210     // FRAME XXX Check
 211     left = right = bottom = openLookMargin;
 212     top = titleHeight + openLookMargin;
 213 }
 214
 215   void
 216 OpenLook::captionChange()
 217 {
 218   widget()->update(titleRect());
 219 }
 220
 221   void
 222 OpenLook::shadeChange()
 223 {
 224 }
 225
 226 QSize OpenLook::minimumSize() const
 227 {
 228     int left, right, top, bottom;
 229     borders(left, right, top, bottom);
 230     return QSize(left  + right + 2 * titleHeight, top + bottom);
 231 }
 232
 233   void
 234 OpenLook::resize(const QSize& s)
 235 {
 236     widget()->resize(s);
 237     widget()->repaint(); //there is some strange wrong repaint of the frame without
 238 }
 239
 240   void
 241 OpenLook::paintEvent(QPaintEvent * pe)
 242 {
 243   QRect tr(titleRect());
 244
 245   QPainter p(widget());
 246
 247   QRegion clipRegion(pe->region());
 248
 249   p.setClipRegion(clipRegion);
 250
 251   paintBorder(p);
 252
 253   paintTopLeftRect(p);
 254   paintTopRightRect(p);
 255   paintBottomLeftRect(p);
 256   paintBottomRightRect(p);
 257
 258   p.setClipRegion(clipRegion + buttonRect());
 259
 260   QBrush titleBackground(options()->color(KDecoration::ColorTitleBar, true));
 261
 262   if (isActive())
 263     qDrawShadePanel(&p, tr, widget()->colorGroup(), true, 1, &titleBackground);
 264   else
 265     p.fillRect(tr, widget()->colorGroup().brush(QColorGroup::Background));
 266
 267   p.setClipRegion(clipRegion);
 268
 269   paintButton(p);
 270
 271   p.setFont(options()->font(isActive(), tool_));
 272
 273   p.setPen(options()->color(KDecoration::ColorFont, isActive()));
 274
 275   tr.setLeft(openLookCornerSize + 3 + buttonRect().width() + 2);
 276
 277   p.drawText(tr, AlignCenter, caption());
 278 }
 279
 280   void
 281 OpenLook::showEvent(QShowEvent *)
 282 {
 283     widget()->repaint();
 284 }
 285
 286   void
 287 OpenLook::mouseDoubleClickEvent(QMouseEvent * e)
 288 {
 289   if (e->button() == Qt::LeftButton && titleRect().contains(e->pos()))
 290   {
 291           titlebarDblClickOperation();
 292   }
 293 }
 294
 295   void
 296 OpenLook::resizeEvent(QResizeEvent* e)
 297 {
 298   widget()->update();
 299 }
 300
 301   void
 302 OpenLook::activeChange()
 303 {
 304   widget()->repaint();
 305 }
 306
 307   KDecoration::Position
 308 OpenLook::mousePosition(const QPoint & p) const
 309 {
 310   if (topLeftRect().contains(p))
 311     return PositionTopLeft;
 312   else if (topRightRect().contains(p))
 313     return PositionTopRight;
 314   else if (bottomLeftRect().contains(p))
 315     return PositionBottomLeft;
 316   else if (bottomRightRect().contains(p))
 317     return PositionBottomRight;
 318   else
 319     return PositionCenter;
 320 }
 321
 322   void
 323 OpenLook::iconChange()
 324 {
 325 }
 326
 327   void
 328 OpenLook::desktopChange()
 329 {
 330 }
 331
 332   void
 333 OpenLook::maximizeChange()
 334 {
 335     widget()->repaint(false);
 336 }
 337
 338   void
 339 OpenLook::doLayout()
 340 {
 341   QVBoxLayout * layout = new QVBoxLayout(widget(), openLookMargin);
 342
 343   titleSpacer_ =
 344     new QSpacerItem
 345     (
 346      0,
 347      titleHeight,
 348      QSizePolicy::Expanding,
 349      QSizePolicy::Fixed
 350     );
 351
 352   layout->addItem(titleSpacer_);
 353
 354   layout->addSpacing(2);
 355
 356   QBoxLayout * midLayout =
 357     new QBoxLayout(layout, QBoxLayout::LeftToRight, 0, 0);
 358
 359   if (isPreview()) {
 360     midLayout->addWidget(new QLabel(
 361           i18n("<center><b>OpenLook preview</b></center>"),
 362           widget()),
 363         1);
 364   } else {
 365     midLayout->addItem( new QSpacerItem( 0, 0 ));
 366   }
 367
 368 }
 369
 370   bool
 371 OpenLook::animateMinimize(bool /*iconify*/)
 372 {
 373 #if 0
 374   QRect icongeom(iconGeometry());
 375
 376   if (!icongeom.isValid())
 377     return false;
 378
 379   QRect wingeom(geometry());
 380
 381   QPainter p(workspaceWidget());
 382
 383   p.setRasterOp(Qt::NotROP);
 384
 385 #if 0
 386   if (iconify)
 387     p.setClipRegion(
 388       QRegion(workspace()->desktopWidget()->rect()) - wingeom
 389       );
 390 #endif
 391
 392   for (uint count = 0; count < 4; count++)
 393   {
 394     grabXServer();
 395
 396     p.drawLine(wingeom.bottomRight(), icongeom.bottomRight());
 397     p.drawLine(wingeom.bottomLeft(), icongeom.bottomLeft());
 398     p.drawLine(wingeom.topLeft(), icongeom.topLeft());
 399     p.drawLine(wingeom.topRight(), icongeom.topRight());
 400
 401     p.flush();
 402
 403     kapp->syncX();
 404
 405     usleep(10000);
 406
 407     p.drawLine(wingeom.bottomRight(), icongeom.bottomRight());
 408     p.drawLine(wingeom.bottomLeft(), icongeom.bottomLeft());
 409     p.drawLine(wingeom.topLeft(), icongeom.topLeft());
 410     p.drawLine(wingeom.topRight(), icongeom.topRight());
 411
 412     p.flush();
 413
 414     kapp->syncX();
 415
 416     usleep(10000);
 417
 418     ungrabXServer();
 419   }
 420 #endif
 421   return true;
 422 }
 423
 424   QRect
 425 OpenLook::topLeftRect() const
 426 {
 427   return QRect
 428     (
 429      0,
 430      0,
 431      openLookCornerSize,
 432      openLookCornerSize
 433     );
 434 }
 435
 436   QRect
 437 OpenLook::topRightRect() const
 438 {
 439   return QRect
 440     (
 441      width() - openLookCornerSize,
 442      0,
 443      openLookCornerSize,
 444      openLookCornerSize
 445     );
 446 }
 447
 448   QRect
 449 OpenLook::bottomLeftRect() const
 450 {
 451   return QRect
 452     (
 453      0,
 454      height() - openLookCornerSize,
 455      openLookCornerSize,
 456      openLookCornerSize
 457     );
 458 }
 459
 460   QRect
 461 OpenLook::bottomRightRect() const
 462 {
 463   return QRect
 464     (
 465      width() - openLookCornerSize,
 466      height() - openLookCornerSize,
 467      openLookCornerSize,
 468      openLookCornerSize
 469     );
 470 }
 471
 472   void
 473 OpenLook::paintTopLeftRect(QPainter & p) const
 474 {
 475   QColor handleColour(options()->color(KDecoration::ColorHandle, isActive()));
 476
 477   QRect r(topLeftRect());
 478
 479   int x1(r.left());
 480   int y1(r.top());
 481   int x2(r.right());
 482   int y2(r.bottom());
 483
 484   p.setPen(widget()->colorGroup().light());
 485
 486   p.drawLine(x1, y1, x2, y1);
 487   p.drawLine(x1, y1 + 1, x1, y2);
 488
 489   p.fillRect(x1 + 1, y1 + 1, r.width()-2, openLookMargin-2,  handleColour);
 490   p.fillRect(x1 + 1, y1 + 1, openLookMargin-2, r.height()-2, handleColour);
 491
 492   p.setPen(widget()->colorGroup().dark());
 493
 494   p.drawLine(x2, y1 + 1, x2, y1 + openLookMargin-1);
 495
 496   p.drawLine(x1 + openLookMargin-1, y1 + openLookMargin-1, x2 - 1, y1 + openLookMargin-1);
 497
 498   p.drawLine(x1 + openLookMargin-1, y1 + openLookMargin, x1 + openLookMargin-1, y2 - 1);
 499
 500   p.drawLine(x1 + 1, y2, x1 + openLookMargin-1, y2);
 501 }
 502
 503   void
 504 OpenLook::paintTopRightRect(QPainter & p) const
 505 {
 506   QColor handleColour(options()->color(KDecoration::ColorHandle, isActive()));
 507
 508   QRect r(topRightRect());
 509
 510   int x1(r.left());
 511   int y1(r.top());
 512   int x2(r.right());
 513   int y2(r.bottom());
 514
 515   p.setPen(widget()->colorGroup().light());
 516
 517   p.drawLine(x1, y1, x2, y1);
 518   p.drawLine(x1, y1 + 1, x1, y1 + openLookMargin-1);
 519   p.drawLine(x2 - openLookMargin+1, y1 + openLookMargin, x2 - openLookMargin+1, y2);
 520
 521   p.fillRect(x1 + 1, y1 + 1, r.width()-2, openLookMargin-2, handleColour);
 522   p.fillRect(x2 - openLookMargin + 2, y1 + 1, openLookMargin-2, r.height()-2, handleColour);
 523
 524   p.setPen(widget()->colorGroup().dark());
 525
 526   p.drawLine(x1 + 1, y1 + openLookMargin-1, x2 - openLookMargin+1, y1 + openLookMargin-1);
 527   p.drawLine(x2, y1 + 1, x2, y2);
 528   p.drawLine(x2 - openLookMargin+1, y2, x2 - 1, y2);
 529 }
 530
 531   void
 532 OpenLook::paintBottomLeftRect(QPainter & p) const
 533 {
 534   QColor handleColour(options()->color(KDecoration::ColorHandle, isActive()));
 535
 536   QRect r(bottomLeftRect());
 537
 538   int x1(r.left());
 539   int y1(r.top());
 540   int x2(r.right());
 541   int y2(r.bottom());
 542
 543   p.setPen(widget()->colorGroup().light());
 544
 545   p.drawLine(x1, y1, x1 + openLookMargin-1, y1);
 546   p.drawLine(x1, y1 + 1, x1, y2);
 547   p.drawLine(x1 + openLookMargin, y2 - openLookMargin+1, x2, y2 - openLookMargin+1);
 548
 549   p.fillRect(x1 + 1, y2 - openLookMargin + 2, r.width()-2, openLookMargin-2, handleColour);
 550   p.fillRect(x1 + 1, y1 + 1, openLookMargin-2, r.height()-2, handleColour);
 551
 552   p.setPen(widget()->colorGroup().dark());
 553
 554   p.drawLine(x1 + openLookMargin-1, y1 + 1, x1 + openLookMargin-1, y2 - openLookMargin);
 555   p.drawLine(x1 + 1, y2, x2, y2);
 556   p.drawLine(x2, y2 - openLookMargin+2, x2, y2 - 1);
 557 }
 558
 559   void
 560 OpenLook::paintBottomRightRect(QPainter & p) const
 561 {
 562   QColor handleColour(options()->color(KDecoration::ColorHandle, isActive()));
 563
 564   QRect r(bottomRightRect());
 565
 566   int x1(r.left());
 567   int y1(r.top());
 568   int x2(r.right());
 569   int y2(r.bottom());
 570
 571   p.setPen(widget()->colorGroup().light());
 572
 573   p.drawLine(x1, y2 - openLookMargin+1, x1, y2);
 574   p.drawLine(x1 + 1, y2 - openLookMargin+1, x2 - openLookMargin+1, y2 - openLookMargin+1);
 575   p.drawLine(x2 - openLookMargin+1, y1 + 1, x2 - openLookMargin+1, y2 - openLookMargin);
 576   p.drawLine(x2 - openLookMargin+1, y1, x2, y1);
 577
 578   p.fillRect(x1 + 1, y2 - openLookMargin + 2, r.width()-2, openLookMargin-2,  handleColour);
 579   p.fillRect(x2 - openLookMargin + 2, y1 + 1, openLookMargin-2, r.height()-2, handleColour);
 580
 581   p.setPen(widget()->colorGroup().dark());
 582
 583   p.drawLine(x1 + 1, y2, x2, y2);
 584   p.drawLine(x2, y1 + 1, x2, y2 - 1);
 585 }
 586
 587   QRect
 588 OpenLook::buttonRect() const
 589 {
 590   return QRect
 591     (
 592       openLookCornerSize + 3,
 593       titleRect().top(),
 594       titleRect().height(),
 595       titleRect().height()
 596     );
 597 }
 598
 599   void
 600 OpenLook::paintButton(QPainter & p) const
 601 {
 602   QRect r(buttonRect());
 603
 604   p.fillRect
 605     (
 606      r.left() + 1,
 607      r.top() + 1,
 608      r.width() - 2,
 609      r.height() - 2,
 610      buttonDown_
 611      ? widget()->colorGroup().dark()
 612      : options()->color(KDecoration::ColorButtonBg, isActive())
 613     );
 614
 615   p.setPen(buttonDown_ ? widget()->colorGroup().dark() : widget()->colorGroup().light());
 616
 617   p.drawLine(r.left() + 1, r.top(), r.right() - 1, r.top());
 618   p.drawLine(r.left(), r.top() + 1, r.left(), r.bottom() - 1);
 619
 620   p.setPen(buttonDown_ ? widget()->colorGroup().light() : widget()->colorGroup().dark());
 621
 622   p.drawLine(r.right(), r.top() + 1, r.right(), r.bottom() - 1);
 623   p.drawLine(r.left() + 1, r.bottom(), r.right() - 1, r.bottom());
 624
 625   paintArrow(p);
 626 }
 627
 628   void
 629 OpenLook::paintArrow(QPainter & p) const
 630 {
 631   QRect br(buttonRect());
 632
 633   int x = br.left()   + 5;
 634   int y = br.top()    + 5;
 635   int w = br.width()  - 10;
 636   int h = br.height() - 10;
 637
 638   Q3PointArray poly(3);
 639
 640   p.setBrush(widget()->colorGroup().mid());
 641
 642   poly.setPoint(0, x, y);
 643   poly.setPoint(1, x + w - 1, y);
 644   poly.setPoint(2, x + (w / 2), y + h - 1);
 645
 646   p.drawPolygon(poly);
 647
 648   p.setPen(widget()->colorGroup().dark());
 649
 650   p.drawLine(x, y, x + w - 1, y);
 651
 652   p.drawLine(x, y, x + (w / 2), y + h - 1);
 653
 654   p.setPen(widget()->colorGroup().light());
 655
 656   p.drawLine(x + (w / 2), y + h - 1, x + w - 1, y);
 657 }
 658
 659   void
 660 OpenLook::paintBorder(QPainter & p) const
 661 {
 662   const uint cs(openLookCornerSize);
 663
 664   uint x = widget()->rect().left();
 665   uint y = widget()->rect().top();
 666   uint w = widget()->rect().width();
 667   uint h = widget()->rect().height();
 668   uint r = widget()->rect().right();
 669   uint b = widget()->rect().bottom();
 670
 671   p.fillRect(x + cs, y, w - cs - cs, 2,     widget()->colorGroup().shadow());
 672   p.fillRect(x + cs, b - 1, w - cs - cs, 2, widget()->colorGroup().shadow());
 673   p.fillRect(x, y + cs, 2, h - cs - cs,     widget()->colorGroup().shadow());
 674   p.fillRect(r - 1, y + cs, 2, h - cs - cs, widget()->colorGroup().shadow());
 675
 676   QColor frameColour(options()->color(KDecoration::ColorFrame, isActive()));
 677
 678   p.fillRect(x + cs, y + 2, w - cs - cs, openLookMargin-2, frameColour);
 679   p.fillRect(x + cs, b - openLookMargin + 1, w - cs - cs, openLookMargin-2, frameColour);
 680   p.fillRect(x + 2, y + cs, openLookMargin-2, h - cs - cs, frameColour);
 681   p.fillRect(r - openLookMargin + 1, y + cs, openLookMargin-2, h - cs - cs, frameColour);
 682
 683   p.fillRect
 684     (
 685      openLookMargin,
 686      titleRect().bottom() + 1,
 687      width() - 2 * openLookMargin,
 688      2,
 689      widget()->colorGroup().background()
 690     );
 691 }
 692
 693   QRect
 694 OpenLook::titleRect() const
 695 {
 696   return titleSpacer_->geometry();
 697 }
 698
 699   bool
 700 OpenLook::isButtonPress(QMouseEvent * e)
 701 {
 702   mousePressPoint_ = e->pos();
 703
 704   buttonDown_ = buttonRect().contains(mousePressPoint_);
 705
 706   widget()->repaint(buttonRect());
 707   return buttonDown_;
 708 }
 709
 710   bool
 711 OpenLook::isButtonRelease(QMouseEvent * e)
 712 {
 713   if (buttonDown_ && buttonRect().contains(e->pos()))
 714   {
 715     minimize();
 716     return true;
 717   }
 718   buttonDown_ = false;
 719   widget()->repaint(buttonRect());
 720
 721   return false;
 722 }
 723
 724 }
 725
 726 #include "OpenLook.moc"
 727 // vim:ts=2:sw=2:tw=78:set et: